Aszinkron Configuration Manager lekérdezés végrehajtása felügyelt kód használatával

Cikk
04/04/2023

A Configuration Manager a ProcessQuery metódussal hajthat végre aszinkron lekérdezést a felügyelt SMS-szolgáltatóval.

A ProcessQuery metódus első paramétere az SmsBackgroundWorker osztály egy példánya, amely két eseménykezelőt biztosít:

QueryProcessObjectReady. Ezt az eseménykezelőt a lekérdezés által visszaadott minden objektumhoz meghívja a program. Az eseménykezelő egy IResultObject objektumot biztosít, amely az objektumot jelöli.
QueryProcessCompleted. Ezt az eseménykezelőt a lekérdezés befejezésekor hívja meg a program. Az esetleges hibákról is tartalmaz információkat. További információ: A hibakezeléssel kapcsolatos információkért lásd: Configuration Manager aszinkron hibák kezelése felügyelt kód használatával.

A ProcessQuery metódus második paramétere a lekérdezés WQL-utasítása.

Aszinkron lekérdezés végrehajtása

Állítson be egy kapcsolatot az SMS-szolgáltatóval. További információ: Az SMS-szolgáltató alapjai.
Hozza létre az SmsBackgroundWorker objektumot, és töltse fel a QueryProcessorObjectReady és a QueryProcessorCompleted tulajdonságokat a visszahívási metódusok nevével.
Az első lépésben beszerzett WqlConnectionManager objektumból hívja meg a QueryProcessor objektum ProcessQuery metódusát az aszinkron lekérdezés elindításához.

Példa

Az alábbi példa lekérdezi az összes elérhető SMS_Collection objektumot, és az eseménykezelőben a példa számos gyűjteménytulajdonságt ír a Configuration Manager konzolra.

A mintakód meghívásával kapcsolatos információkért lásd: Configuration Manager Kódrészletek hívása.

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...");  
}

Ez a példametódus a következő paraméterekkel rendelkezik:

Paraméter	Típus	Leírás
`connection`	Kezelt: `WqlConnectionManager`	Érvényes kapcsolat az SMS-szolgáltatóval.

A kód fordítása

Névterek

Rendszer

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Összeszerelés

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robusztus programozás

A Configuration Manager kivételek az SmsConnectionException és az SmsQueryException. Ezek az SmsException kivétellel együtt is elkaphatók.

Lásd még

Megosztás a következőn keresztül: