DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metódus

Definíció

Névtér:

System.Web.UI

Szerelvény:

System.Web.dll

Frissítési műveletet hajt végre az objektum által képviselt adatok DataSourceView listáján.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Paraméterek

keys

IDictionary

A IDictionary frissítési művelet által frissítendő objektum- vagy sorkulcsok egyike.

values

IDictionary

Név-érték IDictionary párok, amelyek adatelemeket és azok új értékeit jelölik.

oldValues

IDictionary

Név-érték IDictionary párok, amelyek adatelemeket és azok eredeti értékeit jelölik.

Válaszok

Int32

A mögöttes adattárban frissített elemek száma.

Kivételek

NotSupportedException

A ExecuteUpdate(IDictionary, IDictionary, IDictionary) művelet nem támogatott a DataSourceView.

Példák

Az alábbi példakód bemutatja, hogyan bírálhatja felül az osztályt kiterjesztő DataSourceView osztály a CanUpdate tulajdonságot és a metódust ExecuteUpdate . Ez a példakód egy nagyobb, az DataSourceView osztályhoz tartozó példa része.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Megjegyzések

Az adathoz kötött vezérlők az objektum beolvasásával ExecuteUpdate és a tulajdonság értékének ellenőrzésével DataSourceControl.GetView megállapíthatják, hogy az DataSourceView adatforrás-vezérlő támogatja-e a CanUpdate műveletet.

A keys paraméter a frissíteni kívánt adatok objektum- vagy sorkulcsait jelöli. A relációs adatokat , például a SqlDataSource vezérlőt képviselő adatforrások esetében a keys paraméter az adatbázis elsődleges kulcsainak gyűjteménye. Más esetekben a keys paraméter név-érték párok gyűjteménye, és az adatok listájának szűrésére szolgál. A név-érték pároknak megfelelő adatok a paraméterben values található értékekkel frissülnek, amely név-érték párok készlete, amelyek a meglévő mezők vagy oszlopok új értékeit jelölik.

Note

Az DataSourceView osztály alapértelmezett implementációja kivételt NotSupportedException eredményez. Ha kiterjeszti az osztályt DataSourceView , felülbírálja a ExecuteUpdate metódust, ha az osztály támogatja az adatok frissítését az alapul szolgáló adattárban.

Lásd még

• CanUpdate