LinqDataSourceUpdateEventArgs Klas

Definitie

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Overname

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Voorbeelden

In het volgende voorbeeld ziet u een gebeurtenis-handler voor de Updating gebeurtenis. In het voorbeeld ziet u hoe u eigenschappen van de OriginalObject eigenschap en de NewObject eigenschap vergelijkt om te bepalen of de waarde in de Category eigenschap is gewijzigd. Zo ja, dan wordt de CategoryChanged eigenschap van het object in de NewObject eigenschap ingesteld op true.

protected void LinqDataSource_Updating(object sender, LinqDataSourceUpdateEventArgs e)
{
    Product originalProduct = (Product)e.OriginalObject;
    Product newProduct = (Product)e.NewObject;

    if (originalProduct.Category != newProduct.Category)
    {
        newProduct.CategoryChanged = true;
    }
}

Protected Sub LinqDataSource_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs)
    Dim originalProduct As Product
    Dim newProduct As Product

    originalProduct = CType(e.OriginalObject, Product)
    newProduct = CType(e.NewObject, Product)

    If (originalProduct.Category <> newProduct.Category) Then
        newProduct.CategoryChanged = True
    End If
End Sub

In het volgende voorbeeld ziet u een gebeurtenis-handler voor de Updating gebeurtenis. Er worden validatieuitzonderingsberichten weergegeven met behulp van een Label besturingselement.

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
        ByVal e As LinqDataSourceUpdateEventArgs)
    If (e.Exception IsNot Nothing) Then
        For Each innerException As KeyValuePair(Of String, Exception) _
               In e.Exception.InnerExceptions
            Label1.Text &= innerException.Key & ": " & _
                innerException.Value.Message & "<br />"
        Next
        e.ExceptionHandled = True
    End If
End Sub

protected void LinqDataSource_Updating(object sender,
        LinqDataSourceUpdateEventArgs e)
{
    if (e.Exception != null)
    {
        foreach (KeyValuePair<string, Exception> innerException in
             e.Exception.InnerExceptions)
        {
        Label1.Text += innerException.Key + ": " +
            innerException.Value.Message + "<br />";
        }
        e.ExceptionHandled = true;
    }
}

Opmerkingen

Het LinqDataSourceUpdateEventArgs object wordt doorgegeven aan een gebeurtenis-handler voor de Updating gebeurtenis. U kunt het LinqDataSourceUpdateEventArgs object gebruiken om de gegevens te onderzoeken voordat de updatebewerking wordt uitgevoerd in de gegevensbron. Vervolgens kunt u de gegevens valideren, validatieuitzondering onderzoeken die door de gegevensklasse zijn gegenereerd of een waarde wijzigen vóór de update. U kunt de updatebewerking ook annuleren.

Het OriginalObject object bevat de gegevens die oorspronkelijk zijn opgehaald uit de gegevensbron. Het NewObject object bevat de gegevens die tijdens de updatebewerking worden opgeslagen in de gegevensbron.

Als het object dat de gegevensbron vertegenwoordigt een validatie-uitzondering genereert voordat de gegevens worden bijgewerkt, bevat de Exception eigenschap een exemplaar van de LinqDataSourceValidationException klasse. U kunt alle validatie-uitzonderingen ophalen via de InnerExceptions eigenschap. Als er geen validatie-uitzondering wordt gegenereerd, bevat nullde Exception eigenschap . Als u de validatie-uitzonderingen afhandelt en de uitzondering niet opnieuw wilt genereren, stelt u de ExceptionHandled eigenschap in op true.

Standaard worden in het LinqDataSource besturingselement de oorspronkelijke waarden van de gegevensbron opgeslagen in de weergavestatus op de webpagina, met uitzondering van de waarden waarvan ColumnAttribute het kenmerk is gemarkeerd als UpdateCheck.Never. LINQ naar SQL controleert automatisch de integriteit van de gegevens voordat de gegevens worden bijgewerkt. Dit doet u door de huidige waarden in de gegevensbron te vergelijken met de oorspronkelijke waarden die zijn opgeslagen in de weergavestatus. LINQ naar SQL genereert een uitzondering als de waarden in de gegevensbron zijn gewijzigd. U kunt extra gegevensvalidatie uitvoeren door een handler voor de Updating gebeurtenis te maken.

Zie ook

• LINQ naar SQL