> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/portal/portal-widgets/syntax.md). # Syntax PSBlazor ist eine benutzerdefinierte Syntax basierend auf Blazor und Razor Pages. Sie ähnelt XML oder XAML und bietet einen Mechanismus, um eine Benutzeroberfläche deklarativ zu definieren. ## Komponenten Jede Komponente wird mit einem XML-Knoten definiert, wie zum Beispiel ` ``` Das Ergebnis ist eine Seite mit einer definierten Schaltfläche.

### Attribute festlegen Jede Komponente verfügt über verfügbare Attribute. Innerhalb des Code-Editors für die PSBlazor-Seite werden die Attribute für die Komponente, die Sie gerade bearbeiten, automatisch aufgelistet.

Das Festlegen von Attributen erfolgt genauso wie das Festlegen eines beliebigen XML-Attributs. Dieses Beispiel ändert die Schaltfläche in den Danger-Status. ```xml ``` Sobald Sie das Tool speichern, wird die Anzeige aktualisiert. Mit der Schaltfläche im Danger-Status sehen Sie, dass sie nun rot ist.

### Untergeordneter Inhalt Einige Komponenten bieten die Möglichkeit, untergeordneten Inhalt zu definieren. Sie können den Knoten `` verwenden, um anzugeben, dass dies der Fall ist. ```xml ``` Wenn keine anderen Knoten innerhalb des untergeordneten Elements der Komponente angegeben sind, wird angenommen, dass es sich um untergeordneten Inhalt handelt. Das Obige kann folgendermaßen vereinfacht werden. ```xml ``` Einige Komponenten bieten Vorlagenattribute, die durch die Angabe mehrerer untergeordneter Inhaltsknoten mit den entsprechenden Knotennamen festgelegt werden können. Zum Beispiel kann die Tabelle untergeordneten Inhalt haben, der aus Spalten und einer Titelvorlage besteht, die definiert, wie der Titel angezeigt wird. Wenn mehrere untergeordnete Knoten definiert sind, ist `` erforderlich. ```xml My Services

``` ## PowerShell Jedes PSBlazor-Tool oder jede PSBlazor-Komponente hat eine zugehörige PSM1-Datei, die interaktive Logik enthält. Diese Logik kann mit Modulen interagieren, Skripte in PSU aufrufen oder die Oberfläche basierend auf den vom Skript verarbeiteten Daten aktualisieren. ### Ereignis-Callbacks Ereignis-Callbacks treten auf, wenn der Benutzer mit einer PSBlazor-Komponente interagiert. Dies kann Mausklicks, Formularübermittlungen oder Tastatureingaben umfassen. Ereignis-Callbacks sind einfach PowerShell-Funktionen. Folgendes könnte verwendet werden, wenn ein Benutzer auf eine Schaltfläche klickt. ```powershell function OnClick { } ``` ### Argumente Die meisten Ereignis-Callbacks stellen ein Objekt bereit, das Informationen über das Ereignis enthält. Zum Beispiel enthalten Mausereignisse Informationen wie die Koordinaten des Klicks. Sie können darauf zugreifen, indem Sie einen `$EventArgs`-Parameter bereitstellen. ```powershell function OnClick { param($EventArgs) } ``` ### Kontext Einige Komponenten sind kontextabhängig. Zum Beispiel eine Tabellenzeile oder ein Formularelement. Kontextwerte werden mit einem `$Context`-Parameter an den Ereignis-Callback übergeben. ```powershell function OnClick { param($Context) } ``` ## Variablen Variablen können verwendet werden, um die PSBlazor-Komponenten mit Daten aus PowerShell zu aktualisieren. Verwenden Sie das `$Variables`-Wörterbuch, um Variablen abzurufen und festzulegen. ```powershell $Variables["TestVariable"] = "Not Clicked" function OnClick { $Variables["TestVariable"] = "Clicked" } ``` Innerhalb der PSBlazor-Syntax können Sie Variablen ähnlich referenzieren, wie Sie es in PowerShell tun würden. ```xml $TestVariable ``` Sie können Variablen auch in Attributen verwenden. ```xml ``` Variablen können auch komplexe Objekte wie `PSCustomObject` oder `Hashtable` sein. Wenn sie Eigenschaften haben, können Sie diese ebenfalls in der PSBlazor-Syntax referenzieren. ```xml ``` ### Datenbindung Die Datenbindung bietet einen Mechanismus, um Variablen zu aktualisieren, ohne ein PowerShell-Skript aufrufen zu müssen. Um eine Bindung zwischen einem Attribut einer PSBlazor-Komponente zu definieren, verwenden Sie die Syntax `bind-{attribute}`. Zum Beispiel könnten Sie für ein Eingabefeld folgendermaßen an eine `$test`-Variable binden. ```xml ``` In Ihrem PowerShell-Modul könnten Sie dann über das `$Variables`-Objekt auf die Variable zugreifen. ```powershell $Message.Info($Variables["TextValue"]) ``` ### Lebenszyklus Variablen werden gelöscht, wenn ein Benutzer die Seite aktualisiert. Sie werden über diesen Bereich hinaus nicht zwischengespeichert. Jeder Benutzer und jede Tool-Seite verfügt über einen anderen Satz von Variablen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/de/portal/portal-widgets/syntax.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.