LinqDataSourceUpdateEventArgs Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Extensions.dll

Poskytuje data pro událost Updating.

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

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Dědičnost

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Příklady

Následující příklad ukazuje obslužnou rutinu Updating události pro událost. Příklad ukazuje, jak porovnat vlastnosti z OriginalObject vlastnosti a NewObject vlastnost k určení, zda se hodnota ve Category vlastnosti změnila. Pokud ano, CategoryChanged vlastnost objektu ve vlastnosti je nastavená NewObject na truehodnotu .

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

Následující příklad ukazuje obslužnou rutinu Updating události pro událost. Zobrazí všechny zprávy o výjimce ověření pomocí Label ovládacího prvku.

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;  
    }  
}  

Poznámky

Objekt LinqDataSourceUpdateEventArgs se předá jakékoli obslužné rutině Updating události události. Objekt můžete použít LinqDataSourceUpdateEventArgs k prozkoumání dat před provedením operace aktualizace ve zdroji dat. Potom můžete ověřit data, prozkoumat výjimky ověřování vyvolané třídou dat nebo změnit hodnotu před aktualizací. Operaci aktualizace můžete také zrušit.

Objekt OriginalObject obsahuje data, která byla původně načtena ze zdroje dat. Objekt NewObject obsahuje data, která budou uložena ve zdroji dat během operace aktualizace.

Pokud objekt, který představuje zdroj dat vyvolá výjimku ověření před aktualizací dat, Exception vlastnost obsahuje instanci LinqDataSourceValidationException třídy . Všechny výjimky ověřování můžete načíst prostřednictvím InnerExceptions vlastnosti . Pokud se nevyvolá žádná výjimka ověřování, Exception vlastnost obsahuje null. Pokud zpracováváte výjimky ověřování a nechcete, aby se výjimka znovu vyvolala, nastavte vlastnost na ExceptionHandledtrue.

Ve výchozím nastavení LinqDataSource ovládací prvek ukládá původní hodnoty ze zdroje dat ve stavu zobrazení na webové stránce s výjimkou těch, jejichž ColumnAttribute atribut je označen jako UpdateCheck.Never. LINQ to SQL před aktualizací dat automaticky zkontroluje integritu dat. Provede to porovnáním aktuálních hodnot ve zdroji dat s původními hodnotami uloženými ve stavu zobrazení. LINQ to SQL vyvolá výjimku, pokud se hodnoty ve zdroji dat změnily. Další ověření dat můžete provést vytvořením obslužné rutiny Updating události.

Konstruktory

LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException)	Inicializuje novou instanci LinqDataSourceUpdateEventArgs třídy se zadanou výjimkou.
LinqDataSourceUpdateEventArgs(Object, Object)	Inicializuje novou instanci LinqDataSourceUpdateEventArgs třídy .

Vlastnosti

Cancel	Získá nebo nastaví hodnotu označující, zda má být událost zrušena. (Zděděno od CancelEventArgs)
Exception	Získá výjimku, která byla vyvolána při ověřování dat před operací aktualizace.
ExceptionHandled	Získá nebo nastaví hodnotu, která označuje, zda byla výjimka zpracována a že by neměla být vyvolán znovu.
NewObject	Získá objekt obsahující hodnoty, které budou uloženy ve zdroji dat.
OriginalObject	Získá objekt, který obsahuje hodnoty, které byly původně načteny ze zdroje dat.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Technologie LINQ to SQL