LearningModelSession Classe

Definição

Namespace:

Windows.AI.MachineLearning

Usado para avaliar modelos de 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

Herança

Object Platform::Object IInspectable LearningModelSession

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (introduzida na v1.0)

Exemplos

O exemplo a seguir carrega um modelo e cria uma sessão de avaliação com ele.

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

Comentários

Windows Server

Para usar essa API no Windows Server, você deve usar o Windows Server 2019 com a Experiência Desktop.

Acesso thread-safe

Essa API é thread-safe.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1903	18362	LearningModelSession(LearningModel,LearningModelDevice,LearningModelSessionOptions)

Construtores

LearningModelSession(LearningModel)	Cria uma sessão usando o dispositivo padrão.
LearningModelSession(LearningModel, LearningModelDevice)	Cria uma sessão usando o dispositivo especificado.
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)	Cria uma sessão usando o dispositivo especificado e opções de inferência adicionais.

Propriedades

Device	Retorna o dispositivo de avaliação da sessão.
EvaluationProperties	Conjunto de propriedades que controlam a avaliação do modelo.
Model	Retorna o modelo de machine learning treinado para esta sessão.

Métodos

Close()	Fecha o LearningModelSession atual.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
Evaluate(LearningModelBinding, String)	Avalie o modelo de machine learning usando os valores de recurso associados em associações.
EvaluateAsync(LearningModelBinding, String)	Avalie de forma assíncrona o modelo de machine learning usando os valores de recurso já associados em associações.
EvaluateFeatures(IMap<String,Object>, String)	Avalie o modelo de machine learning usando os valores de recurso em recursos.
EvaluateFeaturesAsync(IMap<String,Object>, String)	Avalie de forma assíncrona o modelo de machine learning usando os valores de recurso em recursos.

Confira também

• Windows ML
• Exemplos do Windows ML (Github)