Come eseguire una query Configuration Manager asincrona usando codice gestito

Articolo
04/04/2023

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

Configurare una connessione al provider SMS. Per altre informazioni, vedere Nozioni fondamentali sul provider SMS.
Creare l'oggetto SmsBackgroundWorker e popolare le proprietà QueryProcessorObjectReady e QueryProcessorCompleted con i nomi dei metodi di callback.
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

Namespaces

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

Condividi tramite