ObjectDataSourceView Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

ObjectDataSource Podporuje ovládací prvek a poskytuje rozhraní pro ovládací prvky vázané na data, které umožňují provádět operace s daty s obchodními a datovými objekty.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Dědičnost: Object

DataSourceView
ObjectDataSourceView

Implementuje: IStateManager

Poznámky

Třída ObjectDataSourceView je primárně určena k použití ovládacími prvky vázaných na data, nikoli jako programovatelný objekt v kódu stránky.

Třída ObjectDataSourceView implementuje funkce dat pro ObjectDataSource ovládací prvek, včetně Selectoperací , Update Delete, aInsert, řazení, filtrování a správy nastavení ve stavu zobrazení.

Objekt ObjectDataSourceView se vytvoří pro každou instanci ObjectDataSource třídy za běhu. Volání datových operací instance ObjectDataSource třídy jsou zpracovávány instancí objektu ObjectDataSourceView . Vývojáři stránek nepřistupují k instanci ObjectDataSourceView třídy přímo. Vývojáři ovládacích prvků mohou vytvářet vlastní ovládací prvky dat rozšířením ObjectDataSource tříd a ObjectDataSourceView .

Třída ObjectDataSourceView provádí datové operace voláním metod u obchodních nebo datových objektů pomocí reflexe. Za běhu ovládací prvek vytvoří instanci typu, ObjectDataSource která je identifikována TypeName vlastností, a pak zavolá příslušnou metodu pro datovou operaci. Objekt instance není uložen v mezipaměti objektu ObjectDataSourceView. Objekt je vytvořen a zničen pro každé volání datové metody. Pokud je static metoda (Shared v jazyce Visual Basic), instance se nevytvořila, ale metoda operace s daty je stále volána.

Ovládací prvek ObjectDataSourceView není přímo zpřístupněn vývojářům ObjectDataSource stránek. Místo toho se k vlastnostem a metodám objektu ObjectDataSourceView přistupuje prostřednictvím .ObjectDataSource Například DeleteMethod vlastnost of ObjectDataSourceView se nastavuje nastavením DeleteMethod vlastnosti objektu ObjectDataSource.

Načítání dat

Nejzákladnější operací, kterou zobrazení zdroje dat provádí, je načtení dat z podkladového úložiště dat pomocí Select metody , která načte IEnumerable kolekci datových položek. Následující metody načítání dat, vlastnosti a události jsou implementovány objektem ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvkům vývojářům stránek a dalším volajícím:

Metoda Select
Vlastnost SelectMethod
Vlastnost SelectParameters
Událost Selecting
Událost Selected

Aktualizují se data.

Objekt ObjectDataSourceView podporuje aktualizace dat voláním metody obchodního nebo datového objektu UpdateMethod , která je identifikována vlastností . Ovládací prvky vázané na data, které automaticky provádějí aktualizace, například GridView ovládací prvky a DetailsView , předávají své parametry v IOrderedDictionary rozhraní objektu ObjectDataSourceView zobrazení a objekt zobrazení tyto parametry sloučí se všemi parametry, které se nacházejí v kolekci UpdateParameters .

Následující metody aktualizace, vlastnosti a události jsou implementovány objektem ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvku vývojářům stránek a dalším volajícím:

Metoda Update
Vlastnost UpdateMethod
Vlastnost UpdateParameters
Událost Updating
Událost Updated

Vkládání dat

Objekt ObjectDataSourceView podporuje vkládání nových řádků dat voláním metody obchodního nebo datového objektu, která je identifikována InsertMethod vlastností . Ovládací prvky vázané na data, které automaticky provádějí vložení, například GridView a , předávají své parametry v IOrderedDictionary rozhraní objektu ObjectDataSourceView zobrazení a objekt zobrazení tyto parametry sloučí se všemi parametry, které se nacházejí v kolekci InsertParameters DetailsView.

Následující metody vložení, vlastnosti a události jsou implementovány objektem ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvku vývojářům stránek a dalším volajícím:

Metoda Insert
Vlastnost InsertMethod
Vlastnost InsertParameters
Událost Inserting
Událost Inserted

Odstranění dat

Objekt ObjectDataSourceView podporuje odstranění dat voláním metody obchodního nebo datového objektu, která je identifikována DeleteMethod vlastností . Ovládací prvky vázané na data, které automaticky provádějí odstranění, například GridView a , předávají své parametry v IOrderedDictionary rozhraní objektu ObjectDataSourceView zobrazení a objekt zobrazení tyto parametry sloučí se všemi parametry, které se nacházejí v kolekci DeleteParameters DetailsView. Následující metody odstranění, vlastnosti a události jsou implementovány objektem ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvku vývojářům stránek a dalším volajícím:

Metoda Delete
Vlastnost DeleteMethod
Vlastnost DeleteParameters
Událost Deleting
Událost Deleted

Filtrování a řazení dat

Načítání dat je výkonnější, když data můžete filtrovat dynamicky. Filtrování je podporováno pouze ovládacím prvku, ObjectDataSource pokud Select metoda vrací DataTable objekt nebo DataSet . Vlastnosti a FilterParameters můžete použít FilterExpression k použití dynamického filtrování na načítání dat. Tyto vlastnosti jsou implementovány objektem ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvku ovládacím prvkům vázaných na data a jiným volajícím.

Data, která načítáte, můžete seřadit pomocí ObjectDataSource příkazu tak, že data po načtení seřadíte do paměti. Řazení je podporováno pouze ovládacím prvku, ObjectDataSource pokud Select metoda vrátí DataTable nebo DataSet. Vlastnost CanSort vždy vrací true, protože ObjectDataSourceView nemůže určit typ vrácený metodou Select bez volání metody . Syntaxe SortExpression vlastnosti je stejná DataView.Sort jako u vlastnosti.

Stav zobrazení sledování

Implementuje ObjectDataSourceView IStateManager rozhraní a používá stav zobrazení ke sledování jeho stavu napříč požadavky stránky. LoadViewStateImplementace metod , SaveViewStatea TrackViewState jsou k dispozici pro povolení sledování stavu zobrazení pro ovládací prvek. Další informace najdete v tématu přehled správy stavu ASP.NET.

Konstruktory

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicializuje novou instanci ObjectDataSourceView třídy .

Vlastnosti

CanDelete	Získá hodnotu označující, zda ObjectDataSourceView objekt přidružený k aktuálnímu ObjectDataSource ovládacímu prvku podporuje operaci odstranění.
CanInsert	Získá hodnotu označující, zda ObjectDataSourceView objekt přidružený k aktuálnímu ObjectDataSource ovládacímu prvku podporuje operaci vložení.
CanPage	Získá hodnotu označující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje stránkování načtených dat.
CanRetrieveTotalRowCount	Získá hodnotu označující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje načtení celkového počtu řádků dat kromě sady dat.
CanSort	Získá hodnotu označující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje seřazené zobrazení v podkladovém zdroji dat.
CanUpdate	Získá hodnotu označující, zda ObjectDataSourceView objekt přidružený k aktuálnímu ObjectDataSource ovládacímu prvku podporuje operaci aktualizace.
ConflictDetection	Získá nebo nastaví hodnotu, která určuje, jak ObjectDataSource ovládací prvek provádí aktualizace a odstranění, když se data v řádku v podkladovém úložišti dat změní v době operace.
ConvertNullToDBNull	Získá nebo nastaví hodnotu označující, zda Parameter jsou hodnoty předané operaci aktualizace, vložení nebo odstranění automaticky převedeny z `null` na Value hodnotu.
DataObjectTypeName	Získá nebo nastaví název třídy, který ObjectDataSource ovládací prvek používá pro parametr v datové operaci. Ovládací ObjectDataSource prvek používá zadanou třídu místo Parameter objektů, které jsou v různých kolekcích parametrů.
DeleteMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSourceView objekt vyvolá k odstranění dat.
DeleteParameters	Získá kolekci parametrů, která obsahuje parametry, které jsou používány metodou DeleteMethod .
EnablePaging	Získá nebo nastaví hodnotu označující, zda ovládací prvek zdroje dat podporuje stránkování přes sadu dat, která načítá.
Events	Získá seznam delegátů obslužné rutiny událostí pro zobrazení zdroje dat. (Zděděno od DataSourceView)
FilterExpression	Získá nebo nastaví filtrovací výraz, který se použije, když je volána metoda obchodního objektu SelectMethod , která je identifikována vlastností.
FilterParameters	Získá kolekci parametrů, které jsou přidruženy k jakýmkoli zástupným symbolům parametrů, které jsou v řetězci FilterExpression .
InsertMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSourceView objekt vyvolá k vložení dat.
InsertParameters	Získá kolekci parametrů, která obsahuje parametry, které jsou používány metodou InsertMethod .
IsTrackingViewState	Získá hodnotu označující, zda ObjectDataSourceView objekt ukládá změny do stavu zobrazení.
MaximumRowsParameterName	Získá nebo nastaví název parametru metody načítání dat, který se používá k označení počtu záznamů k načtení pro podporu stránkování zdroje dat.
Name	Získá název zobrazení zdroje dat. (Zděděno od DataSourceView)
OldValuesParameterFormatString	Získá nebo nastaví formátovací řetězec pro použití na názvy parametrů pro původní hodnoty, které jsou předány metodám `Delete` nebo `Update` .
ParsingCulture	Získá nebo nastaví hodnotu, která označuje informace o jazykové verzi se používá při převodu řetězcových hodnot na skutečné typy vlastností za účelem vytvoření objektu typu označeného .DataObjectTypeName
SelectCountMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSourceView ovládací prvek vyvolá k načtení počtu řádků.
SelectMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSourceView ovládací prvek vyvolá k načtení dat.
SelectParameters	Získá kolekci parametrů obsahující parametry, které jsou používány metodou SelectMethod .
SortParameterName	Získá nebo nastaví název parametru metody načítání dat, který se používá k určení výrazu řazení pro podporu řazení zdroje dat.
StartRowIndexParameterName	Získá nebo nastaví název parametru metody načítání dat, který se používá k označení celočíselného indexu prvního záznamu k načtení ze sady výsledků pro podporu stránkování zdroje dat.
TypeName	Získá nebo nastaví název třídy, kterou ObjectDataSource ovládací prvek představuje.
UpdateMethod	Získá nebo nastaví název metody nebo funkce, které ObjectDataSourceView objekt vyvolá k aktualizaci dat.
UpdateParameters	Získá kolekci parametrů obsahující parametry, které jsou používány metodou UpdateMethod .

Metody

CanExecute(String)	Určuje, zda lze provést zadaný příkaz. (Zděděno od DataSourceView)
Delete(IDictionary, IDictionary)	Provede operaci odstranění voláním metody obchodního objektu, která je identifikovaná DeleteMethod vlastností pomocí zadaných `keys` kolekcí a `oldValues` .
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Provede asynchronní operaci odstranění seznamu dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExecuteCommand(String, IDictionary, IDictionary)	Spustí zadaný příkaz. (Zděděno od DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Spustí zadaný příkaz. (Zděděno od DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Provede operaci odstranění pomocí DeleteMethod metody a zadané `keys` kolekce a `oldValues` .
ExecuteInsert(IDictionary)	Provede operaci vložení voláním metody obchodního objektu, která je identifikována InsertMethod vlastností pomocí zadané `values` kolekce.
ExecuteSelect(DataSourceSelectArguments)	Načte data z objektu identifikovaného TypeName vlastností zavoláním metody, která je identifikovaná SelectMethod vlastností a předáním hodnot v kolekci SelectParameters .
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Provede operaci aktualizace voláním metody, která je identifikována UpdateMethod vlastností a pomocí všech parametrů, které jsou zadány v `keys`kolekcích , `values`nebo `oldValues` .
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)
Insert(IDictionary)	Provede operaci vložení voláním metody obchodního objektu, která je identifikována InsertMethod vlastností pomocí zadané `values` kolekce.
Insert(IDictionary, DataSourceViewOperationCallback)	Provede asynchronní vkládání operace se seznamem dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení pro zobrazení zdroje dat.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnDataSourceViewChanged(EventArgs)	DataSourceViewChanged Vyvolá událost. (Zděděno od DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Deleted Vyvolá událost po ObjectDataSourceView dokončení operace odstranění objektu.
OnDeleting(ObjectDataSourceMethodEventArgs)	Deleting Vyvolá událost předtím, než se ObjectDataSourceView objekt pokusí o operaci odstranění.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Filtering Vyvolá událost před pokusem ObjectDataSourceView objektu o operaci filtrování.
OnInserted(ObjectDataSourceStatusEventArgs)	Inserted Vyvolá událost po ObjectDataSourceView dokončení operace vložení objektu.
OnInserting(ObjectDataSourceMethodEventArgs)	Inserting Vyvolá událost před pokusem objektu ObjectDataSourceView o operaci vložení.
OnObjectCreated(ObjectDataSourceEventArgs)	ObjectCreated Vyvolá událost poté, co ObjectDataSourceView vytvoří instanci objektu, který je identifikován TypeName vlastností .
OnObjectCreating(ObjectDataSourceEventArgs)	ObjectCreating Vyvolá událost předtím, ObjectDataSourceView než objekt vytvoří instanci obchodního objektu k provedení datové operace.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	ObjectDisposing Vyvolá událost před objektem ObjectDataSourceView zahodí typ instance.
OnSelected(ObjectDataSourceStatusEventArgs)	Selected Vyvolá událost poté, ObjectDataSourceView co objekt dokončil operaci načtení dat.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Selecting Vyvolá událost před pokusem ObjectDataSourceView objektu o operaci načtení dat.
OnUpdated(ObjectDataSourceStatusEventArgs)	Updated Vyvolá událost po ObjectDataSourceView dokončení operace aktualizace objektu.
OnUpdating(ObjectDataSourceMethodEventArgs)	Updating Vyvolá událost před pokusem objektu ObjectDataSourceView o operaci aktualizace.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Volal metodu RaiseUnsupportedCapabilitiesError(DataSourceView) k porovnání možností požadovaných pro ExecuteSelect(DataSourceSelectArguments) operaci s možnostmi, které zobrazení podporuje. (Zděděno od DataSourceView)
SaveViewState()	Uloží změny stavu zobrazení objektu ObjectDataSourceView od okamžiku, kdy byla stránka odeslána zpět na server.
Select(DataSourceSelectArguments)	Načte data z objektu identifikovaného TypeName vlastností zavoláním metody, která je identifikovaná SelectMethod vlastností a předáním hodnot v kolekci SelectParameters .
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Získá seznam dat asynchronně z podkladového úložiště dat. (Zděděno od DataSourceView)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí, ObjectDataSourceView že objekt sleduje změny stavu zobrazení tak, aby změny mohly být uloženy v objektu ViewState ovládacího prvku a trvalé mezi požadavky na stejnou stránku.
Update(IDictionary, IDictionary, IDictionary)	Provede operaci aktualizace voláním metody, která je identifikována UpdateMethod vlastností a pomocí všech parametrů, které jsou zadány v `keys`kolekcích , `values`nebo `oldValues` .
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Provede asynchronní operaci aktualizace seznamu dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)

Událost

DataSourceViewChanged	Vyvolá se při změně zobrazení zdroje dat. (Zděděno od DataSourceView)
Deleted	Vyvolá se po Delete dokončení operace.
Deleting	Nastane před Delete operací.
Filtering	Nastane před operací filtrování.
Inserted	Vyvolá se po Insert dokončení operace.
Inserting	Nastane před Insert operací.
ObjectCreated	Nastane poté, co ObjectDataSourceView objekt vytvoří instanci typu, který je identifikován TypeName vlastností .
ObjectCreating	Nastane předtím, ObjectDataSourceView než objekt vytvoří instanci typu, který je identifikovaný TypeName vlastností.
ObjectDisposing	Vyvolá se, ObjectDataSourceView když objekt zahodí instanci objektu, který vytvořil.
Selected	Vyvolá se po dokončení operace načtení dat.
Selecting	Nastane před operací načtení dat.
Updated	Vyvolá se po Update dokončení operace.
Updating	Nastane před Update operací.

Explicitní implementace rozhraní

IStateManager.IsTrackingViewState	Popis tohoto člena najdete v tématu IsTrackingViewState.
IStateManager.LoadViewState(Object)	Popis tohoto člena najdete v tématu LoadViewState(Object).
IStateManager.SaveViewState()	Popis tohoto člena najdete v tématu SaveViewState().
IStateManager.TrackViewState()	Popis tohoto člena najdete v tématu TrackViewState().

Platí pro