LearningModel 類別

定義

命名空間:

Windows.AI.MachineLearning

表示定型的機器學習模型。

public ref class LearningModel sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.AI.MachineLearning.MachineLearningContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LearningModel final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.AI.MachineLearning.MachineLearningContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LearningModel : System.IDisposable

Public NotInheritable Class LearningModel
Implements IDisposable

繼承

Object Platform::Object IInspectable LearningModel

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable

Windows 需求

裝置系列	Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract	Windows.AI.MachineLearning.MachineLearningContract (已於 v1.0 引進)

範例

下列範例會載入模型，並為其建立評估會話。

private async Task LoadModelAsync(string _modelFileName)
{
    LearningModel _model;
    LearningModelSession _session;

    try
    {
        // Load and create the model
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
        _model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Create the evaluation session with the model
        _session = new LearningModelSession(_model);

    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        _model = null;
    }
}

備註

這是您用來與 Windows ML 互動的主要物件。 您可以使用它來載入、系結及評估定型的 ONNX 模型：

1. 使用其中一個 Load* 建構函式 載入模型。
2. 列舉 InputFeatures 和 OutputFeatures ，並系結至您的模型。
3. 建立 LearningModelSession 和規避。

Windows Server

若要在 Windows Server 上使用此 API，您必須搭配桌面體驗使用 Windows Server 2019。

執行緒安全

此 API 是安全線程。

屬性

Author	模型作者的名稱。
Description	模型的描述。
Domain	模型的領域。
InputFeatures	模型的輸入特徵清單。
Metadata	ONNX 模型中的原始 < 字串、字串 > 中繼資料。
Name	模型的名稱。
OutputFeatures	模型的輸出功能清單。
Version	模型的版本。

方法

Close()	釋放記憶體內部 ONNX 模型。 呼叫此專案之後，您無法再建立任何 LearningModelSession 物件。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
LoadFromFilePath(String)	從磁片上的檔案載入 ONNX 模型。
LoadFromFilePath(String, ILearningModelOperatorProvider)	從磁片上的檔案載入 ONNX 模型。
LoadFromStorageFileAsync(IStorageFile)	以非同步方式從 IStorageFile 載入 ONNX 模型。
LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)	以非同步方式從 IStorageFile 載入 ONNX 模型。
LoadFromStream(IRandomAccessStreamReference)	從資料流程載入 ONNX 模型。
LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)	從資料流程載入 ONNX 模型。
LoadFromStreamAsync(IRandomAccessStreamReference)	以非同步方式從資料流程載入 ONNX 模型。
LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)	以非同步方式從資料流程載入 ONNX 模型。

另請參閱

• Windows ML
• (GitHub) 的 Windows ML 範例