Configuration Manager AssemblyType-Aktion

Artikel
04/04/2023

Die AssemblyType Aktion definiert den Typ und die Assembly für eine Methode, die von der Configuration Manager-Konsole aufgerufen wird.

Hinweis

Der XML- und C#-Code in diesem Thema ist im Beispiel dialog prototype im Configuration Manager SDK verfügbar.

Die folgenden Attribute und Elemente sind spezifisch für eine Aktion, die eine Methode in einer Assembly aufruft:

Das Class -Attribut des ActionDescription -Elements ist auf AssemblyTypefestgelegt.
Das ActionAssembly Element verfügt über eine Reihe von untergeordneten Elementen, die zum Definieren der Methode und Assembly verwendet werden.
Das Assembly -Element identifiziert die Assembly, die die -Methode enthält. Wenn sich die Assembly in einem anderen Ordner als %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin befindet, sollte das Assembly Element den Dateinamen der Assembly und den vollständigen Pfad zur Datei enthalten.
Das Type -Element enthält den Namespace und die Klasse für die -Methode.
Das Method -Element enthält den Namen der methode, die aufgerufen werden soll.

Methode

Die Methodensignatur lautet:

public static void Method(object, ScopeNode, ActionDescription, IResultObject, PropertyDataUpdated, Status)

Dabei sind die Parameter wie folgt:

object
Das -Objekt, das die -Methode aufruft.

ScopeNode
Der Configuration Manager Konsolenknoten, der beim Aufrufen der Aktion aktiv war.

ActionDescription
Die ActionDescription Klasseninstanz, die die Aktion initiiert hat.

IResultObject
Das ausgewählte Objekt oder null , wenn kein ausgewähltes Objekt vorhanden ist.

PropertyDataUpdated
Der delegat, der geöffnet werden soll, um Updateinformationen für die Configuration Manager Konsolenansicht bereitzustellen.

Status
Ermöglicht die Steuerung der Configuration Manager Statusanzeige der Konsole ausgelastet.

Beispielimplementierung

Es folgt ein Beispiel für die Implementierung der -Methode.

public static void Method(object sender, ScopeNode scopeNode, ActionDescription action, IResultObject resultObject, PropertyDataUpdated dataUpdatedDelegate, Status status)   
{  
    if (resultObject != null)   
    {  
        MessageBox.Show(string.Format("The {0} package was selected", resultObject["Name"].StringValue));   
    }  
    else  
    {  
        MessageBox.Show("No package was selected");  
    }  
}

AssemblyType-Aktions-XML

Im folgenden XML-Beispiel wird veranschaulicht, wie eine -Methode in Methodeiner -Klasse aufgerufen wird SampleClass. Die -Methode befindet sich in der Assembly AdminUI.PrototypeDialog.dll.

<ActionDescription Class="AssemblyType" DisplayName="Test Action (method)" MnemonicDisplayName="Mnemonic" Description="Description">  
  <ShowOn>  
    <string>DefaultHomeTab</string>  
    <string>ContextMenu</string>  
  </ShowOn>  
  <ActionAssembly>  
    <Assembly>AdminUI.PrototypeDialog.dll</Assembly>  
    <Type>Microsoft.ConfigurationManagement.AdminConsole.PrototypeDialog.ExampleClass</Type>  
    <Method>Method</Method>  
    <!--Method signature: public static void Method(object sender, ScopeNode scopeNode, ActionDescription action, IResultObject resultObject, PropertyDataUpdated dataUpdatedDelegate, Status status)-->   
  </ActionAssembly>  
</ActionDescription>

Siehe auch

Erstellen einer Configuration Manager Aktion
Configuration Manager Aktionen
Configuration Manager-Aktions-XML
Suchen einer Configuration Manager Knoten-GUID

Freigeben über