ASP.NET Core Blazor-Datenbindung

In diesem Artikel erfahren Sie mehr über die Datenbindungsfeatures für Razor-Komponenten und DOM-Elemente in Blazor-Apps.

Binden von Funktionen

Razor Komponenten bieten Datenbindungsfunktionen mit dem @bindRazor-Direktivenattribut mit einem Feld, einer Eigenschaft oder einem Razor-Ausdruckswert.

Im folgenden Beispiel werden Elemente gebunden:

• Ein <input>-Elementwert an das C#-Feld inputValue.
• Ein zweiter <input>-Elementwert an die C#-Eigenschaft InputValue.

Wenn ein <input>-Element den Fokus verliert, wird das gebundene Feld oder die Eigenschaft aktualisiert.

Bind.razor:

@page "/bind"

<PageTitle>Bind</PageTitle>

<h1>Bind Example</h1>

<p>
    <label>
        inputValue: 
        <input @bind="inputValue" />
    </label>
</p>

<p>
    <label>
        InputValue: 
        <input @bind="InputValue" />
    </label>
</p>

<ul>
    <li><code>inputValue</code>: @inputValue</li>
    <li><code>InputValue</code>: @InputValue</li>
</ul>

@code {
    private string? inputValue;

    private string? InputValue { get; set; }
}

Das Textfeld wird in der Benutzeroberfläche nur dann aktualisiert, wenn die Komponente gerendert wird, nicht als Reaktion auf die Änderung des Werts des Felds oder der Eigenschaft. Da sich Komponenten nach der Ausführung von Ereignishandlercode selbst rendern, werden Feld- und Eigenschaftsaktualisierungen in der Regel unmittelbar nach dem Auslösen eines Ereignishandlers in der Benutzeroberfläche widergespiegelt.

Als Veranschaulichung, wie sich die Datenbindung in HTML zusammensetzt, bindet das folgende Beispiel die Eigenschaft InputValue an die Attribute value und onchange des zweiten <input>-Elements (change). Das zweite <input>-Element im folgenden Beispiel ist eine Konzeptdemo und soll nicht zeigen, wie Daten in Razor-Komponenten gebunden werden sollen.

BindTheory.razor:

@page "/bind-theory"

<PageTitle>Bind Theory</PageTitle>

<h1>Bind Theory Example</h1>

<p>
    <label>
        Normal Blazor binding: 
        <input @bind="InputValue" />
    </label>
</p>

<p>
    <label>
        Demonstration of equivalent HTML binding: 
        <input value="@InputValue" @onchange="@((ChangeEventArgs __e) =>
            InputValue = __e?.Value?.ToString())" />
    </label>
</p>

<p>
    <code>InputValue</code>: @InputValue
</p>

@code {
    private string? InputValue { get; set; }
}

Wenn die BindTheory-Komponente gerendert wird, stammt der value des <input>-Elements der HTML-Demo aus der InputValue-Eigenschaft. Wenn der Benutzer einen Wert in das Textfeld eingibt und den Elementfokus ändert, wird das onchange-Ereignis ausgelöst und die InputValue-Eigenschaft auf den geänderten Wert festgelegt. In Wirklichkeit ist die Codeausführung komplexer, weil @bind Fälle verarbeitet, in denen Typkonvertierungen durchgeführt werden. Im Allgemeinen ordnet @bind den aktuellen Wert eines Ausdrucks dem value-Attribut der <input> zu und behandelt Änderungen mit dem registrierten Handler.

Binden Sie eine Eigenschaft oder ein Feld an andere DOM-Ereignisse, indem Sie ein @bind:event="{EVENT}"-Attribut mit einem DOM-Ereignis für den Platzhalter {EVENT} einbinden. Im folgenden Beispiel wird die InputValue-Eigenschaft an den Wert des <input>-Elements gebunden, wenn das oninput-Ereignis (input) des Elements ausgelöst wird. Im Gegensatz zum onchange-Ereignis (change), das ausgelöst wird, wenn das Element den Fokus verliert, wird oninput (input) ausgelöst, wenn sich der Wert des Textfelds ändert.

Page/BindEvent.razor:

@page "/bind-event"

<PageTitle>Bind Event</PageTitle>

<h1>Bind Event Example</h1>

<p>
    <label>
        InputValue: 
        <input @bind="InputValue" @bind:event="oninput" />
    </label>
    
</p>

<p>
    <code>InputValue</code>: @InputValue
</p>

@code {
    private string? InputValue { get; set; }
}

Verwenden Sie @bind:after="{EVENT}" mit einem DOM-Ereignis für den {EVENT} Platzhalter, um asynchroner Logik nach der Bindung ausführen. Eine zugewiesene C#-Methode wird erst ausgeführt, wenn der gebundene Wert synchron zugewiesen wird.

Die Verwendung eines Ereignisrückrufparameters (EventCallback/EventCallback<T>) mit @bind:after wird nicht unterstützt. Übergeben Sie stattdessen eine Methode, die ein Action- oder Task-Element an @bind:after zurückgibt.

Im folgenden Beispiel:

• Jedes value eines <input>-Elements ist synchron an das searchText-Feld gebunden.
• Die PerformSearch-Methode wird asynchron ausgeführt:
  • Wenn das erste Feld den Fokus verliert (onchange-Ereignis), nachdem der Wert geändert wurde
  • Nach jedem Tastenanschlag (oninput-Ereignis) im zweiten Feld
• PerformSearch ruft einen Dienst mit einer asynchronen Methode (FetchAsync) auf, um Suchergebnisse zurückzugeben.

@inject ISearchService SearchService

<input @bind="searchText" @bind:after="PerformSearch" />
<input @bind="searchText" @bind:event="oninput" @bind:after="PerformSearch" />

@code {
    private string? searchText;
    private string[]? searchResult;

    private async Task PerformSearch() => 
        searchResult = await SearchService.FetchAsync(searchText);
}

Weitere Beispiele

BindAfter.razor:

@page "/bind-after"
@using Microsoft.AspNetCore.Components.Forms

<h1>Bind After Examples</h1>

<h2>Elements</h2>

<input type="text" @bind="text" @bind:after="() => { }" />

<input type="text" @bind="text" @bind:after="After" />

<input type="text" @bind="text" @bind:after="AfterAsync" />

<h2>Components</h2>

<InputText @bind-Value="text" @bind-Value:after="() => { }" />

<InputText @bind-Value="text" @bind-Value:after="After" />

<InputText @bind-Value="text" @bind-Value:after="AfterAsync" />

@code {
    private string text = "";

    private void After() {}
    private Task AfterAsync() { return Task.CompletedTask; }
}

Weitere Informationen zur InputText-Komponente finden Sie unter ASP.NET Core Blazor-Eingabekomponenten.

Komponenten unterstützen die Zwei-Wege-Datenbindung durch Definieren eines Parameterpaars:

• @bind:get gibt den Wert an, der gebunden werden soll.
• @bind:set gibt einen Rückruf zum Zeitpunkt einer Änderung des Werts an.

Die Modifizierer @bind:get und @bind:set werden immer zusammen verwendet.

Beispiele

BindGetSet.razor:

@page "/bind-get-set"
@using Microsoft.AspNetCore.Components.Forms

<h1>Bind Get Set Examples</h1>

<h2>Elements</h2>

<input type="text" @bind:get="text" @bind:set="(value) => { text = value; }" />
<input type="text" @bind:get="text" @bind:set="Set" />
<input type="text" @bind:get="text" @bind:set="SetAsync" />

<h2>Components</h2>

<InputText @bind-Value:get="text" @bind-Value:set="(value) => { text = value; }" />
<InputText @bind-Value:get="text" @bind-Value:set="Set" />
<InputText @bind-Value:get="text" @bind-Value:set="SetAsync" />

@code {
    private string text = "";

    private void Set(string value)
    {
        text = value;
    }

    private Task SetAsync(string value)
    {
        text = value;
        return Task.CompletedTask;
    }
}

Weitere Informationen zur InputText-Komponente finden Sie unter ASP.NET Core Blazor-Eingabekomponenten.

Ein weiteres Beispiel für die Verwendung von @bind:get und @bind:set finden Sie im Abschnitt Binden über mehr als zwei Komponenten weiter unten in diesem Artikel.

Bei der Razor-Attributbindung wird Groß-/Kleinschreibung berücksichtigt:

• @bind, @bind:event, und @bind:after sind gültig.
• @Bind/@bind:Event/@bind:aftEr (Großbuchstaben ) oder @BIND/@BIND:EVENT/@BIND:AFTER (alle Großbuchstaben) sind ungültig.

Verwenden von @bind:get/@bind:set-Modifizierern und Vermeiden von Ereignishandlern für bidirektionale Datenbindung

Bidirektionale Datenbindung kann nicht mit einem Ereignishandler implementiert werden. Verwenden Sie @bind:get/@bind:set-Modifizierer für bidirektionale Datenbindung.

❌ Betrachten Sie den folgenden dysfunktionalen Ansatz für bidirektionale Datenbindung mithilfe eines Ereignishandlers:

<p>
    <input value="@inputValue" @oninput="OnInput" />
</p>

<p>
    <code>inputValue</code>: @inputValue
</p>

@code {
    private string? inputValue;

    private void OnInput(ChangeEventArgs args)
    {
        var newValue = args.Value?.ToString() ?? string.Empty;

        inputValue = newValue.Length > 4 ? "Long!" : newValue;
    }
}

Der OnInput-Ereignishandler aktualisiert den Wert von inputValue in Long!, nachdem ein viertes Zeichen angegeben wurde. Der Benutzer kann jedoch weiterhin Zeichen zum Elementwert in der Benutzeroberfläche hinzufügen. Der Wert von inputValue wird bei jeder Tasteneingabe nicht erneut an den Wert des Elements gebunden. Im vorherigen Beispiel ist nur unidirektionale Datenbindung möglich.

Der Grund für dieses Verhalten liegt darin, dass Blazor nicht bekannt ist, dass Ihr Code beabsichtigt, den Wert von inputValue im Ereignishandler zu ändern. Blazor versucht nicht, die Übereinstimmung von DOM-Elementwerten und .NET-Variablenwerten zu erzwingen, es sei denn, sie sind mit der @bind-Syntax gebunden. In früheren Versionen von Blazor wurde bidirektionale Datenbindung implementiert, indem das Element an eine Eigenschaft gebunden und der Wert der Eigenschaft mit dem Setter gesteuert wurde. In ASP.NET Core mit .NET 7 oder höher wird die @bind:get/@bind:set-Modifizierersyntax verwendet, um die bidirektionale Datenbindung zu implementieren, wie im nächsten Beispiel veranschaulicht wird.

✔️ Ziehen Sie den folgenden richtigen Ansatz mit @bind:get/@bind:set für bidirektionale Datenbindung in Betracht:

<p>
    <input @bind:event="oninput" @bind:get="inputValue" @bind:set="OnInput" />
</p>

<p>
    <code>inputValue</code>: @inputValue
</p>

@code {
    private string? inputValue;

    private void OnInput(string value)
    {
        var newValue = value ?? string.Empty;

        inputValue = newValue.Length > 4 ? "Long!" : newValue;
    }
}

Mit @bind:get/@bind:set-Modifizierern wird der zugrunde liegenden Wert von inputValue über @bind:set gesteuert und der Wert von inputValue über @bind:get an den Wert des Elements gebunden. Im vorherigen Beispiel wird der richtige Ansatz für die Implementierung bidirektionaler Datenbindung veranschaulicht.

Binden an eine Eigenschaft mit C#-get und set-Zugriffsmethoden

C# get und setZugriffsmethoden können verwendet werden, um ein benutzerdefiniertes Bindungsformatverhalten zu erstellen, wie die folgende DecimalBinding-Komponente veranschaulicht. Die Komponente bindet eine positive oder negative Dezimalzahl mit bis zu drei Dezimalstellen über eine string-Eigenschaft (DecimalValue) an ein <input>-Element.

DecimalBinding.razor:

@page "/decimal-binding"
@using System.Globalization

<PageTitle>Decimal Binding</PageTitle>

<h1>Decimal Binding Example</h1>

<p>
    <label>
        Decimal value (±0.000 format):
        <input @bind="DecimalValue" />
    </label>
</p>

<p>
    <code>decimalValue</code>: @decimalValue
</p>

@code {
    private decimal decimalValue = 1.1M;
    private NumberStyles style = 
        NumberStyles.AllowDecimalPoint | NumberStyles.AllowLeadingSign;
    private CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");

    private string DecimalValue
    {
        get => decimalValue.ToString("0.000", culture);
        set
        {
            if (Decimal.TryParse(value, style, culture, out var number))
            {
                decimalValue = Math.Round(number, 3);
            }
        }
    }
}

Hinweis

Für die bidirektionale Bindung an eine Eigenschaft mit get/set-Accessoren ist es erforderlich, das von EventCallback.InvokeAsync zurückgegebene Task-Element zu verwerfen. Für bidirektionale Datenbindung wird die Verwendung von @bind:get/@bind:set-Modifizierern empfohlen. Weitere Informationen finden Sie im Leitfaden @bind:get/@bind:set weiter oben in diesem Artikel.

Auswahl der Option „multiple“ für <select>-Elemente

Die Bindung unterstützt die Auswahl der Option multiple für <select>-Elemente. Das @onchange-Ereignis stellt ein Array der ausgewählten Elemente über Ereignisargumente (ChangeEventArgs) zur Verfügung. Der Wert muss an einen Arraytyp gebunden werden.

BindMultipleInput.razor:

@page "/bind-multiple-input"

<h1>Bind Multiple <code>input</code>Example</h1>

<p>
    <label>
        Select one or more cars: 
        <select @onchange="SelectedCarsChanged" multiple>
            <option value="audi">Audi</option>
            <option value="jeep">Jeep</option>
            <option value="opel">Opel</option>
            <option value="saab">Saab</option>
            <option value="volvo">Volvo</option>
        </select>
    </label>
</p>

<p>
    Selected Cars: @string.Join(", ", SelectedCars)
</p>

<p>
    <label>
        Select one or more cities: 
        <select @bind="SelectedCities" multiple>
            <option value="bal">Baltimore</option>
            <option value="la">Los Angeles</option>
            <option value="pdx">Portland</option>
            <option value="sf">San Francisco</option>
            <option value="sea">Seattle</option>
        </select>
    </label>
</p>

<span>
    Selected Cities: @string.Join(", ", SelectedCities)
</span>

@code {
    public string[] SelectedCars { get; set; } = new string[] { };
    public string[] SelectedCities { get; set; } = new[] { "bal", "sea" };

    private void SelectedCarsChanged(ChangeEventArgs e)
    {
        if (e.Value is not null)
        {
            SelectedCars = (string[])e.Value;
        }
    }
}

Informationen dazu, wie leere Zeichenfolgen und null-Werte in der Datenbindung behandelt werden, finden Sie im Abschnitt Binden von Optionen des <select>-Elements an null-Werte von C#-Objekten.

Binden von <select>-Elementoptionen an null-Werte von C#-Objekten

Es gibt aus folgenden Gründen keine vernünftige Möglichkeit, den Optionswert eines <select>-Elements als null-Wert eines C#-Objekts darzustellen:

• HTML-Attribute können keine null-Werte aufweisen. null entspricht in HTML am ehesten dem Nichtvorhandensein des value-HTML-Attributs im <option>-Element.
• Wenn Sie ein <option>-Element ohne value-Attribut auswählen, behandelt der Browser den Wert als Textinhalt dieses <option>-Elements.

Das Blazor-Framework versucht nicht, das Standardverhalten zu unterdrücken, weil dies Folgendes beinhalten würde:

• Erstellen einer Kette von Problemumgehungen für Sonderfälle im Framework.
• Breaking Changes am aktuellen Frameworkverhalten.

Das plausibelste Äquivalent zu null in HTML ist eine value mit einer leeren Zeichenfolge. Das Blazor-Framework verarbeitet null als Konvertierung einer leeren Zeichenfolge für eine bidirektionale Bindung an einen <select>-Wert.

Nicht analysierbare Werte

Wenn ein Benutzer einem Element mit Datenbindung einen nicht analysierbaren Wert zur Verfügung stellt, wird der nicht analysierbare Wert automatisch auf seinen vorherigen Wert zurückgesetzt, wenn das Bindungsereignis ausgelöst wird.

Beachten Sie die folgende Komponente, in der ein <input>-Element an einen int-Typ mit einem Anfangswert von 123 gebunden ist.

UnparsableValues.razor:

@page "/unparsable-values"

<PageTitle>Unparsable Values</PageTitle>

<h1>Unparsable Values Example</h1>

<p>
    <label>
        inputValue: 
        <input @bind="inputValue" />
    </label>
    
</p>

<p>
    <code>inputValue</code>: @inputValue
</p>

@code {
    private int inputValue = 123;
}

Die Verknüpfung gilt für das Ereignis onchange des Elements. Wenn der Benutzer den Wert des Eintrags des Textfelds in 123.45 aktualisiert und den Fokus ändert, wird der Wert des Elements beim Auslösen von onchange auf 123 zurückgesetzt. Wenn der Wert 123.45 zugunsten des ursprünglichen Werts von 123 abgelehnt wird, versteht der Benutzer, dass sein Wert nicht akzeptiert wurde.

Für das oninput-Ereignis (@bind:event="oninput") erfolgt die Wertumkehr nach jedem Tastendruck, der einen nicht analysierbaren Wert einführt. Wenn das oninput-Ereignis mit einem int-gebundenen Typ adressiert wird, wird ein Benutzer daran gehindert, ein Punktzeichen (.) einzugeben. Ein Punktzeichen (.) wird sofort entfernt, sodass der Benutzer sofort die Rückmeldung erhält, dass nur ganze Zahlen zulässig sind. Es gibt Szenarien, in denen die Umkehrung des Werts auf das oninput Ereignis nicht ideal ist, z. B. wenn dem Benutzer erlaubt werden soll, einen nicht analysierbaren <input>-Wert zu löschen. Zu den Alternativen gehören:

• Verwenden Sie nicht das Ereignis oninput. Verwenden Sie das Standardereignis onchange, bei dem ein ungültiger Wert erst dann zurückgesetzt wird, wenn das Element den Fokus verliert.
• Binden Sie an einen Nullable-Typ, z. B. int? oder string, und verwenden Sie entweder @bind:get/@bind:set-Modifizierer (weiter oben in diesem Artikel beschrieben), oder binden Sie an eine Eigenschaft mit benutzerdefinierter get- und set-Accessorlogik, um ungültige Einträge zu behandeln.
• Verwenden Sie eine Eingabekomponente, z. B. InputNumber<TValue> oder InputDate<TValue> mit einer Formularüberprüfung. Eingabekomponenten zusammen mit Formularüberprüfungskomponenten bieten integrierte Unterstützung zum Verwalten ungültiger Eingaben:
  • Erlauben Sie dem Benutzer, ungültige Eingaben zu machen und Überprüfungsfehler für das zugehörige EditContext zu erhalten.
  • Zeigen Sie Überprüfungsfehler auf der Benutzeroberfläche an, ohne den Benutzer bei der Eingabe zusätzlicher WebForm-Daten zu beeinträchtigen.

Formatzeichenfolgen

Datenbindung funktioniert mit einer einzelnen DateTime-Formatzeichenfolge mit@bind:format="{FORMAT STRING}", wobei der Platzhalter {FORMAT STRING} die Formatzeichenfolge ist. Andere Formatausdrücke, z. B. Währungs- oder Zahlenformate, sind zurzeit nicht verfügbar, werden jedoch möglicherweise in einem zukünftigen Release hinzugefügt.

DateBinding.razor:

@page "/date-binding"

<PageTitle>Date Binding</PageTitle>

<h1>Date Binding Example</h1>

<p>
    <label>
        <code>yyyy-MM-dd</code> format:
        <input @bind="startDate" @bind:format="yyyy-MM-dd" />
    </label>
</p>

<p>
    <code>startDate</code>: @startDate
</p>

@code {
    private DateTime startDate = new(2020, 1, 1);
}

Im Code oben ist der Feldtyp des <input>-Elements (type-Attribut) standardmäßig auf text festgelegt.

Die Nullable-Typen System.DateTime und System.DateTimeOffset werden unterstützt:

private DateTime? date;
private DateTimeOffset? dateOffset;

Die Angabe eines Formats für den Feldtyp date wird nicht empfohlen, da Blazor eine integrierte Unterstützung für die Formatierung von Daten bietet. Verwenden Sie trotz der Empfehlung nur dann das Datumsformat yyyy-MM-dd für die Bindung, um ordnungsgemäß zu funktionieren, wenn ein Format mit dem Feldtyp date bereitgestellt wird:

<input type="date" @bind="startDate" @bind:format="yyyy-MM-dd">

Binden mit Komponentenparametern

Ein häufiges Szenario besteht darin, eine Eigenschaft einer untergeordneten Komponente an eine Eigenschaft in ihrer übergeordneten Komponente zu binden. Dieses Szenario wird als verkettete Bindung bezeichnet, da mehrere Ebenen der Bindung gleichzeitig auftreten.

Verkettete Bindungen können nicht mit der @bind-Syntax in einer untergeordneten Komponente implementiert werden. Separat müssen ein Ereignishandler und ein Wert angegeben werden, um die Aktualisierung der Eigenschaft in der übergeordneten Komponente zu unterstützen. Die übergeordnete Komponente nutzt weiterhin die @bind-Syntax, um die Datenbindung mit der untergeordneten Komponente festzulegen.

Die folgende ChildBind-Komponente (Year) verfügt über einen Komponentenparameter und einen EventCallback<TValue>. Gemäß der Konvention muss EventCallback<TValue> für den Parameter wie der Name des Komponentenparameters mit einem Suffix „Changed“ benannt werden. Die Benennungssyntax ist {PARAMETER NAME}Changed, wobei der Platzhalter {PARAMETER NAME} der Parametername ist. Im folgenden Beispiel trägt EventCallback<TValue> den Namen YearChanged.

EventCallback.InvokeAsync ruft den Delegaten, der der Bindung zugeordnet ist, mit dem bereitgestellten Argument auf und sendet eine Ereignisbenachrichtigung über die geänderte Eigenschaft.

ChildBind.razor:

<div class="card bg-light mt-3" style="width:18rem ">
    <div class="card-body">
        <h3 class="card-title">ChildBind Component</h3>
        <p class="card-text">
            Child <code>Year</code>: @Year
        </p>
        <button @onclick="UpdateYearFromChild">Update Year from Child</button>
    </div>
</div>

@code {
    [Parameter]
    public int Year { get; set; }

    [Parameter]
    public EventCallback<int> YearChanged { get; set; }

    private async Task UpdateYearFromChild() => 
        await YearChanged.InvokeAsync(Random.Shared.Next(1950, 2021));
}

Weitere Informationen zu Ereignissen und EventCallback<TValue> finden Sie im Abschnitt EventCallback des Artikels Ereignisbehandlung in Blazor in ASP.NET Core.

In der folgenden Parent1-Komponente ist das Feld year an den Year-Parameter der untergeordneten Komponente gebunden. Der Parameter Year ist bindbar, da er ein Begleitereignis YearChanged aufweist, das dem Typ des Parameters Year entspricht.

Parent1.razor:

@page "/parent-1"

<PageTitle>Parent 1</PageTitle>

<h1>Parent Example 1</h1>

<p>Parent <code>year</code>: @year</p>

<button @onclick="UpdateYear">Update Parent <code>year</code></button>

<ChildBind @bind-Year="year" />

@code {
    private int year = 1979;

    private void UpdateYear() => year = Random.Shared.Next(1950, 2021);
}

Die Komponentenparameterbindung kann auch @bind:after Ereignisse auslösen. Im folgenden Beispiel wird die Methode YearUpdated nach Bindung des Komponentenparameters Year asynchron ausgeführt.

<ChildBind @bind-Year="year" @bind-Year:after="YearUpdated" />

@code {
    ...

    private async Task YearUpdated()
    {
        ... = await ...;
    }
}

Gemäß der Konvention kann eine Eigenschaft an einen entsprechenden Ereignishandler gebunden werden, indem ein @bind-{PROPERTY}:event-Attribut einbezogen wird, das dem Handler zugewiesen ist, wobei der Platzhalter {PROPERTY} die Eigenschaft darstellt. <ChildBind @bind-Year="year" /> ist identisch mit dem folgenden Code:

<ChildBind @bind-Year="year" @bind-Year:event="YearChanged" />

In einem komplexeren Beispiel aus der Praxis führt die PasswordEntry-Komponente Folgendes aus:

• Legt den Wert eines <input>-Elements auf ein password-Feld fest.
• Macht Änderungen einer Password-Eigenschaft einer übergeordneten Komponente mit einem EventCallback verfügbar, der den aktuellen Wert des password-Felds des untergeordneten Elements als Argument übergibt.
• Verwendet das onclick-Ereignis zum Auslösen der ToggleShowPassword-Methode. Weitere Informationen finden Sie unter Ereignisbehandlung in Blazor in ASP.NET Core.

PasswordEntry.razor:

<div class="card bg-light mt-3" style="width:22rem ">
    <div class="card-body">
        <h3 class="card-title">Password Component</h3>
        <p class="card-text">
            <label>
                Password:
                <input @oninput="OnPasswordChanged"
                       required
                       type="@(showPassword ? "text" : "password")"
                       value="@password" />
            </label>
        </p>
        <button class="btn btn-primary" @onclick="ToggleShowPassword">
            Show password
        </button>
    </div>
</div>

@code {
    private bool showPassword;
    private string? password;

    [Parameter]
    public string? Password { get; set; }

    [Parameter]
    public EventCallback<string> PasswordChanged { get; set; }

    private async Task OnPasswordChanged(ChangeEventArgs e)
    {
        password = e?.Value?.ToString();

        await PasswordChanged.InvokeAsync(password);
    }

    private void ToggleShowPassword() => showPassword = !showPassword;
}

Die PasswordEntry-Komponente wird in einer anderen Komponente verwendet, wie im folgenden PasswordBinding-Komponentenbeispiel.

PasswordBinding.razor:

@page "/password-binding"

<PageTitle>Password Binding</PageTitle>

<h1>Password Binding Example</h1>

<PasswordEntry @bind-Password="password" />

<p>
    <code>password</code>: @password
</p>

@code {
    private string password = "Not set";
}

Wenn die PasswordBinding Komponente zum ersten Mal gerendert wird, wird der password-Wert von Not set auf der Benutzeroberfläche angezeigt. Nach dem ersten Rendering berücksichtigt der Wert von password Änderungen, die am Password-Komponentenparameterwert in der PasswordEntry-Komponente vorgenommen wurden.

Hinweis

Im obigen Beispiel wird das Kennwort von der untergeordneten PasswordEntry-Komponente einseitig an die übergeordnete PasswordBinding-Komponente gebunden. Eine zweiseitige Bindung ist in diesem Szenario nicht erforderlich, wenn das Ziel darin besteht, dass die App über eine freigegebene Kennworteingabekomponente für die Wiederverwendung in der App verfügt, die das Kennwort lediglich an das übergeordnete Element übergibt. Eine Vorgehensweise, die eine zweiseitige Bindung ohne direktes Schreiben in den Parameter der untergeordneten Komponente zulässt, finden Sie im NestedChild-Komponentenbeispiel im Abschnitt Binden über mehr als zwei Komponenten dieses Artikels.

Führen Sie die Prüfungen durch, oder fangen Sie Fehler im Handler ab. Die folgende überarbeitete PasswordEntry-Komponente gibt dem Benutzer sofortiges Feedback, wenn ein Leerzeichen im Wert des Kennworts verwendet wird.

PasswordEntry.razor:

<div class="card bg-light mt-3" style="width:22rem ">
    <div class="card-body">
        <h3 class="card-title">Password Component</h3>
        <p class="card-text">
            <label>
                Password:
                <input @oninput="OnPasswordChanged"
                       required
                       type="@(showPassword ? "text" : "password")"
                       value="@password" />
            </label>
            <span class="text-danger">@validationMessage</span>
        </p>
        <button class="btn btn-primary" @onclick="ToggleShowPassword">
            Show password
        </button>
    </div>
</div>

@code {
    private bool showPassword;
    private string? password;
    private string? validationMessage;

    [Parameter]
    public string? Password { get; set; }

    [Parameter]
    public EventCallback<string> PasswordChanged { get; set; }

    private Task OnPasswordChanged(ChangeEventArgs e)
    {
        password = e?.Value?.ToString();

        if (password != null && password.Contains(' '))
        {
            validationMessage = "Spaces not allowed!";

            return Task.CompletedTask;
        }
        else
        {
            validationMessage = string.Empty;

            return PasswordChanged.InvokeAsync(password);
        }
    }

    private void ToggleShowPassword() => showPassword = !showPassword;
}

Binden über mehr als zwei Komponenten

Sie können Parameter über eine beliebige Anzahl geschachtelter Komponenten binden, Sie müssen aber den unidirektionalen Datenfluss berücksichtigen:

• Änderungsbenachrichtigungen durchlaufen die Hierarchie von unten nach oben.
• Neue Parameterwerte durchlaufen die Hierarchie von oben nach unten.

Ein gängiges und empfohlenes Verfahren besteht darin, nur die zugrunde liegenden Daten in der übergeordneten Komponente zu speichern, damit Sie immer genau wissen, welcher Zustand aktualisiert werden muss, wie im folgenden Beispiel gezeigt.

Parent2.razor:

@page "/parent-2"

<PageTitle>Parent 2</PageTitle>

<h1>Parent Example 2</h1>

<p>Parent Message: <b>@parentMessage</b></p>

<p>
    <button @onclick="ChangeValue">Change from Parent</button>
</p>

<NestedChild @bind-ChildMessage="parentMessage" />

@code {
    private string parentMessage = "Initial value set in Parent";

    private void ChangeValue() => parentMessage = $"Set in Parent {DateTime.Now}";
}

In der folgenden NestedChild Komponente, macht die NestedGrandchild Komponente folgendes:

• Weist den Wert von ChildMessage oder GrandchildMessage mit @bind:get-Syntax zu.
• Aktualisiert GrandchildMessage, wenn ChildMessageChanged mit @bind:set-Syntax ausgeführt wird.

NestedChild.razor:

<div class="border rounded m-1 p-1">
    <h2>Child Component</h2>

    <p>Child Message: <b>@ChildMessage</b></p>

    <p>
        <button @onclick="ChangeValue">Change from Child</button>
    </p>

    <NestedGrandchild @bind-GrandchildMessage:get="ChildMessage" 
        @bind-GrandchildMessage:set="ChildMessageChanged" />
</div>

@code {
    [Parameter]
    public string? ChildMessage { get; set; }

    [Parameter]
    public EventCallback<string?> ChildMessageChanged { get; set; }

    private async Task ChangeValue() => 
        await ChildMessageChanged.InvokeAsync($"Set in Child {DateTime.Now}");
}

NestedGrandchild.razor:

<div class="border rounded m-1 p-1">
    <h3>Grandchild Component</h3>

    <p>Grandchild Message: <b>@GrandchildMessage</b></p>

    <p>
        <button @onclick="ChangeValue">Change from Grandchild</button>
    </p>
</div>

@code {
    [Parameter]
    public string? GrandchildMessage { get; set; }

    [Parameter]
    public EventCallback<string> GrandchildMessageChanged { get; set; }

    private async Task ChangeValue() => 
        await GrandchildMessageChanged.InvokeAsync(
            $"Set in Grandchild {DateTime.Now}");
}

Einen alternativen Ansatz, der sich für die gemeinsame Nutzung von Daten im Arbeitsspeicher über Komponenten hinweg eignet, die nicht unbedingt geschachtelt sind, finden Sie unter Zustandsverwaltung in Blazor in ASP.NET Core.

Gebundenes Feld oder Eigenschaftsausdrucksbaum

Um tiefere Interaktionen mit einer Bindung zu vereinfachen, können Sie mit Blazor die Ausdrucksbaumstruktur eines gebundenen Felds oder einer gebundenen Eigenschaft erfassen. Dies wird erreicht, indem eine Eigenschaft definiert wird, die vor dem Feld- oder Eigenschaftennamen das Suffix Expression erhält. Für ein bestimmtes Feld oder eine Eigenschaft mit dem Namen {FIELD OR PROPERTY NAME} trägt die entsprechende Eigenschaft der Ausdrucksbaumstruktur den Namen {FIELD OR PROPERTY NAME}Expression.

Die folgende ChildParameterExpression-Komponente identifiziert das Modell und den Feldnamen des Year-Ausdrucks. FieldIdentifier wird zum Abrufen des Modells und des Feldnamens verwendet und identifiziert eindeutig ein einzelnes Feld, das bearbeitet werden kann. Dies kann einer Eigenschaft für ein Modellobjekt entsprechen oder ein beliebiger anderer benannter Wert sein. Die Verwendung des Ausdrucks eines Parameters ist nützlich, wenn benutzerdefinierte Validierungskomponenten erstellt werden, die nicht von der Microsoft-Dokumentation für Blazor abgedeckt werden, aber von einigen Ressourcen von Drittanbietern.

ChildParameterExpression.razor:

@using System.Linq.Expressions

<ul>
    <li>Year model: @yearField.Model</li>
    <li>Year field name: @yearField.FieldName</li>
</ul>

@code {
    private FieldIdentifier yearField;

    [Parameter]
    public int Year { get; set; }

    [Parameter]
    public EventCallback<int> YearChanged { get; set; }

    [Parameter]
    public Expression<Func<int>> YearExpression { get; set; } = default!;

    protected override void OnInitialized() => 
        yearField = FieldIdentifier.Create(YearExpression);
}

Parent3.razor:

@page "/parent-3"

<PageTitle>Parent 3</PageTitle>

<h1>Parent Example 3</h1>

<p>Parent <code>year</code>: @year</p>

<ChildParameterExpression @bind-Year="year" />

@code {
    private int year = 1979;
}

Zusätzliche Ressourcen

• Parameteränderungserkennung und zusätzliche Anleitungen zum Rendern von Razor Komponenten
• Übersicht über ASP.NET Core Blazor-Formulare
• Binden an Optionsfelder in einem Formular
• Binden von InputSelect-Optionen an null-Werte von C#-Objekten
• Blazor-Ereignisbehandlung in ASP.NET Core: Abschnitt „EventCallback“
• GitHub-Repository mit Blazor-Beispielen (dotnet/blazor-samples) (Informationen zum Herunterladen)