Verwenden von Objekten, die an ein Configuration Manager-Formular übergeben werden

In Configuration Manager verwenden Sie das SmsPageControl.PropertyManager-Objekt, um auf Objekte zuzugreifen, die in der Configuration Manager-Konsole ausgewählt sind.

Hinweis

Wenn in der Configuration Manager-Konsole kein Objekt ausgewählt ist, wird ein leeres PropertyManager-Objekt erstellt und an das Formular übergeben. Dies kann zum Erstellen neuer Objekte verwendet werden.

Das Formular verwaltet die Serialisierung von Objekten im PropertyManager-Objekt, und alle Änderungen, die Sie vornehmen, werden automatisch gespeichert, wenn Sie auf OK klicken, oder sie werden beim Klicken auf Abbrechen abgebrochen.

Abhängig vom SelectionMode-Attribut des ActionDescription-Elements der Aktion können mehrere Objekte an das PropertyManager-Objekt übergeben werden. Änderungen, die Sie mithilfe des PropertyManager-Objekts vornehmen, werden dann auf alle übergebenen Objekte angewendet. Wenn Sie auf die einzelnen Objekte zugreifen möchten, müssen Sie das PropertyManager-Objekt in einen ResultObjectsManager umwandeln. Anschließend greifen Sie über die ResultObjectsManager-Objektauflistung auf die Objekte zu.

Weitere Informationen finden Sie unter Configuration Manager Action XML.

Informationen zum Abrufen des Eigenschaften-Managers in einem Dialogfeld finden Sie unter Erstellen eines Configuration Manager Dialogfelds.

Anzeigen des Paketnamens

Das folgende Verfahren veranschaulicht die Verwendung eines PropertyManager-Objekts für den Zugriff auf ein einzelnes Objekt, das an ein Eigenschaftenblatt übergeben wird. Wenn Sie auf eine Schaltfläche klicken, wird ein Meldungsfeld angezeigt, das den Namen eines ausgewählten Pakets enthält. Um diese Schritte auszuführen, müssen Sie zuerst die Aktionen in den folgenden Themen ausführen:

So zeigen Sie den Paketnamen an

  1. Wenn die Configuration Manager-Konsole geöffnet ist, schließen Sie sie.

  2. Öffnen Sie in Visual Studio 2010 das Projekt, das Sie unter Erstellen eines Configuration Manager Eigenschaftenblatts erstellt haben.

  3. Klicken Sie Projektmappen-Explorer mit der rechten Maustaste auf ConfigMgrControl.cs, und klicken Sie dann auf Designer anzeigen.

  4. Klicken Sie in der Toolbox auf die Registerkarte Allgemeine Steuerelemente , und doppelklicken Sie dann auf Schaltfläche. Dem Steuerelement im Benutzersteuerungs-Designer wird eine Schaltfläche mit dem Namen button1 hinzugefügt.

  5. Doppelklicken Sie im Benutzersteuerungs-Designer auf button1 , und geben Sie den folgenden Code in den button1_Click Methodenquellcode ein, der angezeigt wird:

    MessageBox.Show(string.Format("The {0} package was selected", PropertyManager["Name"].StringValue));  
    
  6. Erstellen Sie das Projekt, und kopieren Sie die Assembly in den Ordner %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin.

  7. Öffnen Sie die Configuration Manager-Konsole, und navigieren Sie unter Softwareverteilung zum Knoten Pakete.

  8. Klicken Sie mit der rechten Maustaste auf ein Paket, und klicken Sie dann auf Dialogfeld anzeigen. Das Dialogfeld wird angezeigt.

  9. Klicken Sie auf die Schaltfläche, und der Name des Pakets wird im Dialogfeld angezeigt.

Siehe auch

Informationen zu Configuration Manager Forms
Binden von Configuration Manager Daten an ein Formular