LearningModelSession Classe

Definizione

Spazio dei nomi:

Windows.AI.MachineLearning

Usato per valutare i modelli di Machine Learning.

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

Ereditarietà

Object Platform::Object IInspectable LearningModelSession

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene caricato un modello e viene creata una sessione di valutazione.

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

Commenti

Windows Server

Per usare questa API in Windows Server, è necessario usare Windows Server 2019 con Esperienza desktop.

Thread safety

Questa API è thread-safe.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1903	18362	LearningModelSession(LearningModel,LearningModelDevice,LearningModelSessionOptions)

Costruttori

LearningModelSession(LearningModel)	Crea una sessione usando il dispositivo predefinito.
LearningModelSession(LearningModel, LearningModelDevice)	Crea una sessione usando il dispositivo specificato.
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)	Crea una sessione usando le opzioni di inferenza e dispositivo specificato.

Proprietà

Device	Restituisce il dispositivo di valutazione della sessione.
EvaluationProperties	Set di proprietà che controllano la valutazione del modello.
Model	Restituisce il modello di Machine Learning sottoposto a training per questa sessione.

Metodi

Close()	Chiude l'oggetto LearningModelSession corrente.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
Evaluate(LearningModelBinding, String)	Valutare il modello di Machine Learning usando i valori delle funzionalità associati nelle associazioni.
EvaluateAsync(LearningModelBinding, String)	Valutare in modo asincrono il modello di Machine Learning usando i valori di funzionalità già associati nelle associazioni.
EvaluateFeatures(IMap<String,Object>, String)	Valutare il modello di Machine Learning usando i valori delle funzionalità nelle funzionalità.
EvaluateFeaturesAsync(IMap<String,Object>, String)	Valutare in modo asincrono il modello di Machine Learning usando i valori delle funzionalità nelle funzionalità.

Vedi anche

• Windows ML
• Esempi di Windows ML (GitHub)