LearningModelSession Klasse

Definition

Namespace:

Windows.AI.MachineLearning

Wird zum Auswerten von Machine Learning-Modellen verwendet.

public ref class LearningModelSession sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.AI.MachineLearning.ILearningModelSessionFactory, 65536, "Windows.AI.MachineLearning.MachineLearningContract")]
/// [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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.AI.MachineLearning.ILearningModelSessionFactory2, 131072, "Windows.AI.MachineLearning.MachineLearningContract")]
class LearningModelSession final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.AI.MachineLearning.ILearningModelSessionFactory), 65536, "Windows.AI.MachineLearning.MachineLearningContract")]
[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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.AI.MachineLearning.ILearningModelSessionFactory2), 131072, "Windows.AI.MachineLearning.MachineLearningContract")]
public sealed class LearningModelSession : System.IDisposable

function LearningModelSession(model, deviceToRunOn, learningModelSessionOptions)

Public NotInheritable Class LearningModelSession
Implements IDisposable

Vererbung

Object Platform::Object IInspectable LearningModelSession

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird ein Modell geladen und damit eine Auswertungssitzung erstellt.

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;
    }
}

Hinweise

Windows Server

Um diese API unter Windows Server verwenden zu können, müssen Sie Windows Server 2019 mit Desktopoberfläche verwenden.

Threadsicherheit

Diese API ist threadsicher.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1903	18362	LearningModelSession(LearningModel,LearningModelDevice,LearningModelSessionOptions)

Konstruktoren

LearningModelSession(LearningModel)	Erstellt eine Sitzung mit dem Standardgerät.
LearningModelSession(LearningModel, LearningModelDevice)	Erstellt eine Sitzung mit dem angegebenen Gerät.
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)	Erstellt eine Sitzung mit dem angegebenen Gerät und zusätzlichen Rückschlussoptionen.

Eigenschaften

Device	Gibt das Auswertungsgerät der Sitzung zurück.
EvaluationProperties	Satz von Eigenschaften, die die Modellauswertung steuern.
Model	Gibt das trainierte Machine Learning-Modell für diese Sitzung zurück.

Methoden

Close()	Schließt die aktuelle LearningModelSession.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
Evaluate(LearningModelBinding, String)	Bewerten Sie das Machine Learning-Modell mithilfe der in Bindungen gebundenen Featurewerte.
EvaluateAsync(LearningModelBinding, String)	Asynchrones Auswerten des Machine Learning-Modells mithilfe der Featurewerte, die bereits in Bindungen gebunden sind.
EvaluateFeatures(IMap<String,Object>, String)	Bewerten Sie das Machine Learning-Modell mithilfe der Featurewerte in Features.
EvaluateFeaturesAsync(IMap<String,Object>, String)	Asynchrones Auswerten des Machine Learning-Modells mithilfe der Featurewerte in Features.

Weitere Informationen

• Windows ML
• Beispiele für Windows ML (GitHub)