> 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/it/portale/portal-widgets/syntax.md). # Sintassi PSBlazor è una sintassi personalizzata basata su Blazor e sulle pagine Razor. È simile a XML o XAML e fornisce un meccanismo per definire in modo dichiarativo un'interfaccia utente. ## Componenti Ogni componente è definito con un nodo XML, come ` ``` Il risultato è una pagina con un pulsante definito.

### Impostare gli attributi Ogni componente dispone di attributi. All'interno dell'editor di codice della pagina PSBlazor, gli attributi verranno elencati automaticamente per il componente che sta modificando.

Impostare gli attributi è come impostare qualsiasi attributo XML. Questo esempio cambia il pulsante allo stato danger. ```xml ``` Una volta salvato lo strumento, la visualizzazione verrà aggiornata. Con il pulsante nello stato danger, vedrà che ora è rosso.

### Contenuto figlio Alcuni componenti offrono la possibilità di definire contenuto figlio. Può usare il nodo `` per specificarlo. ```xml ``` Se non vengono specificati altri nodi all'interno del figlio del componente, si presume che si tratti di contenuto figlio. Quanto sopra può essere semplificato in questo modo. ```xml ``` Alcuni componenti forniscono attributi template che possono essere impostati specificando più nodi di contenuto figlio con i nomi di nodo appropriati. Ad esempio, la tabella può avere contenuto figlio costituito da colonne e un template di titolo che definisce come viene visualizzato il titolo. Quando sono definiti più nodi figlio, `` è obbligatorio. ```xml My Services

``` ## PowerShell Ogni strumento o componente PSBlazor ha un file PSM1 associato che contiene la logica interattiva. Questa logica può interagire con i moduli, invocare script in PSU o aggiornare l'interfaccia in base ai dati elaborati dallo script. ### Callback di eventi I callback di eventi si verificano quando l'utente interagisce con un componente PSBlazor. Ciò può includere clic del mouse, invii di moduli o input da tastiera. I callback di eventi sono semplicemente funzioni PowerShell. Quanto segue potrebbe essere utilizzato quando un utente fa clic su un pulsante. ```powershell function OnClick { } ``` ### Argomenti La maggior parte dei callback di eventi fornisce un oggetto che contiene informazioni sull'evento. Ad esempio, gli eventi del mouse includono informazioni come le coordinate del clic. Può accedervi fornendo un parametro `$EventArgs`. ```powershell function OnClick { param($EventArgs) } ``` ### Contesto Alcuni componenti sono contestuali. Ad esempio, una riga di tabella o un elemento di un modulo. I valori di contesto vengono passati al callback dell'evento tramite un parametro `$Context`. ```powershell function OnClick { param($Context) } ``` ## Variabili Le variabili possono essere utilizzate per aggiornare i componenti PSBlazor con dati provenienti da PowerShell. Utilizzi il dizionario `$Variables` per ottenere e impostare le variabili. ```powershell $Variables["TestVariable"] = "Not Clicked" function OnClick { $Variables["TestVariable"] = "Clicked" } ``` All'interno della sintassi PSBlazor, può fare riferimento alle variabili in modo simile a quanto farebbe in PowerShell. ```xml $TestVariable ``` Può anche utilizzare le variabili negli attributi. ```xml ``` Le variabili possono anche essere oggetti complessi come `PSCustomObject` o `Hashtable`. Se hanno proprietà, può fare riferimento anche a queste nella sintassi PSBlazor. ```xml ``` ### Data binding Il data binding fornisce un meccanismo per aggiornare le variabili senza dover chiamare uno script PowerShell. Per definire un'associazione tra un attributo di un componente PSBlazor, utilizzi la sintassi `bind-{attribute}`. Ad esempio, potrebbe associare una variabile `$test` a una casella di input in questo modo. ```xml ``` Nel suo modulo PowerShell, potrebbe quindi accedere alla variabile dall'oggetto `$Variables`. ```powershell $Message.Info($Variables["TextValue"]) ``` ### Ciclo di vita Le variabili vengono cancellate quando un utente aggiorna la pagina. Non vengono memorizzate nella cache oltre questo ambito. Ogni utente e ogni pagina dello strumento avrà un insieme diverso di variabili. --- # 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/it/portale/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.