Come eseguire una query Configuration Manager asincrona usando codice gestito

In Configuration Manager, per eseguire una query asincrona usando il provider SMS gestito, usare il metodo ProcessQuery.

Il primo parametro del metodo ProcessQuery è un'istanza della classe SmsBackgroundWorker che fornisce due gestori eventi:

• QueryProcessObjectReady. Questo gestore eventi viene chiamato per ogni oggetto restituito dalla query. Il gestore eventi fornisce un oggetto IResultObject che rappresenta l'oggetto .

• QueryProcessCompleted. Questo gestore eventi viene chiamato al termine della query. Fornisce inoltre informazioni sugli eventuali errori che si verificano. Per altre informazioni, vedere Per informazioni sulla gestione degli errori, vedere Come gestire Configuration Manager errori asincroni tramite codice gestito.

  Il secondo parametro a del metodo ProcessQuery è l'istruzione WQL per la query.

Per eseguire una query asincrona

1. Configurare una connessione al provider SMS. Per altre informazioni, vedere Nozioni fondamentali sul provider SMS.

2. Creare l'oggetto SmsBackgroundWorker e popolare le proprietà QueryProcessorObjectReady e QueryProcessorCompleted con i nomi dei metodi di callback.

3. Dall'oggetto WqlConnectionManager ottenuto nel passaggio 1, chiamare il metodo ProcessQuery dell'oggetto QueryProcessor per avviare la query asincrona.

Esempio

Nell'esempio seguente vengono eseguite query per tutti gli oggetti SMS_Collection disponibili e nel gestore eventi vengono scritte diverse proprietà della raccolta nella console di Configuration Manager.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice Configuration Manager.

public void QueryCollections(WqlConnectionManager connection)
{
    try
    {
        // Set up the query.
        SmsBackgroundWorker bw1 = new SmsBackgroundWorker();
        bw1.QueryProcessorObjectReady += new EventHandler<QueryProcessorObjectEventArgs>(bw1_QueryProcessorObjectReady);
        bw1.QueryProcessorCompleted += new EventHandler<RunWorkerCompletedEventArgs>(bw1_QueryProcessorCompleted);

        // Query for all collections.
        connection.QueryProcessor.ProcessQuery(bw1, "select * from SMS_Collection");

        // Pause while query runs.
        Console.ReadLine();
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed to start asynchronous query: ", ex.Message);
    }
}

void bw1_QueryProcessorObjectReady(object sender, QueryProcessorObjectEventArgs e)
{
    try
    {
        // Get the collection.
        IResultObject collection = (IResultObject)e.ResultObject;

        //Display properties.
        Console.WriteLine(collection["CollectionID"].StringValue);
        Console.WriteLine(collection["Name"].StringValue);
        Console.WriteLine();
        collection.Dispose();
    }
    catch (SmsQueryException eX)
    {
        Console.WriteLine("Query Error: " + eX.Message);
    }
}

void bw1_QueryProcessorCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    Console.WriteLine("Done...");
}

Questo metodo di esempio include i parametri seguenti:

Parametro	Tipo	Descrizione
connection	Gestito: WqlConnectionManager	Connessione valida al provider SMS.

Compilazione del codice

Spazi dei nomi

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmazione efficiente

Le eccezioni Configuration Manager che possono essere generate sono SmsConnectionException e SmsQueryException. Questi possono essere intercettati insieme a SmsException.

Vedere anche

Panoramica degli oggettiConfiguration Manager Proprietà lazyCome chiamare un metodo della classe oggetto Configuration Manager tramite codice gestitoCome connettersi a un provider di Configuration Manager usando codice gestitoCome creare un oggetto Configuration Manager object by Using Managed CodeHow to Modify a Configuration Manager Object by Using Managed CodeHow to Perform a Synchronous Configuration Manager Query by Using Managed CodeHow to Read a Configuration Manager Oggetto tramite codice gestitoCome leggere le proprietà lazy usando codice gestitoCome eseguire una query di Configuration Manager sincrona usando codice gestitoConfiguration Manager linguaggio di query WMI estesoConfiguration Manager set di risultatiConfiguration Manager query specialisulle query