Main Content

mdfCreate

用元数据创建 MDF 文件

自 R2022a 起

全页折叠

    语法

    mdfCreate(mdfFileName)
    mdfCreate(mdfFileName,FileInfo=mdfInfoObj)
    newMDFFile = mdfCreate(___)

    说明

    示例

    mdfCreate(mdfFileName) 使用默认文件元数据在 mdfFileName 指定的位置创建一个 MDF 文件。文件名必须包括扩展名 .dat、.mdf 或 .mf4。mdfFileName 可以指定绝对或完整路径，或为远程服务器上的文件指定 URL。

    示例

    mdfCreate(mdfFileName,FileInfo=mdfInfoObj) 使用创建文件时可配置的指定元数据来创建一个 MDF 文件。对象 mdfInfoObj 必须采用由 mdfInfo 函数返回的形式，您可以用它来创建对象，然后根据需要修改它。mdfInfoObj.Version 属性支持的值包括 "3.00"、"3.10"、"3.20"、"3.30"、"4.00"、"4.10" 和 "4.20"。

    newMDFFile = mdfCreate(___) 会创建一个 MDF 文件，并将其完整路径名称作为字符串返回给变量 newMDFFile。当指定部分或相对路径来创建文件时，返回的完整路径会非常有用。

    示例

    全部折叠

    新建一个 MDF 文件，并查看其元数据。

    mdfCreate("MDF_25Dec.mf4")
    ans = 

    "C:\data\mdf\MDF_25Dec.mf4"
    mdfInfo("MDF_25Dec.mf4")
    ans = 

  MDFInfo with properties:

   File Details
                  Name: "MDF_25Dec.mf4"
                  Path: "C:\data\mdf\MDF_25Dec.mf4"
                Author: ""
            Department: ""
               Project: ""
               Subject: ""
               Comment: ""
               Version: "4.20"
      InitialTimestamp: 2022-10-20 18:39:41.000000000

   Creator Details
     ProgramIdentifier: "MATLAB"
     CreatorVendorName: "The MathWorks, Inc."
       CreatorToolName: "MATLAB"
    CreatorToolVersion: "9.14.0.2081372 (R2023a)"
       CreatorUserName: ""
        CreatorComment: ""

   File Contents
            Attachment: [0×8 table]
     ChannelGroupCount: 0

    使用修改后的元数据新建一个 MDF 文件。

    创建一个默认信息对象，设置其属性，并创建一个新 MDF 文件。

    minfo = mdfInfo;
minfo.Comment = "25-Dec Shift B.";
minfo.Version = "4.10";
%   ⋮
% Modify other properites as needed.
%   ⋮
mdfCreate("MyMDFfile.mf4",FileInfo=minfo);

    使用从现有文件中获取的元数据创建一个新 MDF 文件。

    minfo = mdfInfo("MyMDFfile1.mf4");  % Existing MDF file.
info.Version = "4.10";
createdFilePath = mdfCreate("MyMDFfile2.mf4", FileInfo=info) % New file, with matadata from existing file.

    输入参数

    全部折叠

    要创建的 MDF 文件名，指定为字符串或字符向量。文件名可以是相对或绝对路径。该名称必须包括扩展名 .dat、.mdf 或 .mf4。

    根据您要访问的位置，mdfFileName 可以采用以下形式之一。

    位置

    形式

    当前文件夹或 MATLAB® 路径

    要访问当前文件夹或 MATLAB 路径中的文件，请在 filename 中指定文件名（包括文件扩展名）。

    示例："myMdfFile.mf4"

    其他文件夹

    要访问当前文件夹以外的文件夹中的文件，请在 filename 中指定完整或相对路径名称。

    示例："C:\myFolder\myMdfFile.mf4"

    示例："\dataDir\myMdfFile.mf4"

    远程位置

    要访问远程位置的文件，filename 必须包含指定为统一资源定位器 (URL) 形式的文件的完整路径：

    scheme://path_to_file/myMdfFile.mf4

    根据远程位置，scheme 可以是下表中的值之一。

    远程位置scheme
    Amazon S3™s3
    Windows Azure® Blob 存储wasb, wasbs
    HDFS™hdfs

    有关详细信息，请参阅处理远程数据。

    示例："s3://bucketname/path_to_file/myMdfFile.mf4"

    示例: "MDF_25Dec.mf4"

    数据类型: char | string

    输出参量

    全部折叠

    新建的 MDF 文件的完整路径名称，以字符串形式返回。

    限制

    • mdfCreate 不支持添加自定义文件元数据字段。

    版本历史记录

    在 R2022a 中推出

    全部展开

    另请参阅

    函数