ObjectDataSourceView Třída

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 k provádění operací 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 určena především k použití ovládacími prvky svázanými daty, a ne jako programovatelný objekt v kódu stránky.

Třída ObjectDataSourceView implementuje funkce dat pro ObjectDataSource ovládací prvek, včetně Select, Update, Deletea Insert operací, řazení, filtrování a správy nastavení uchovávané 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 zpracovává instance objektu ObjectDataSourceView . Vývojáři stránek nemají přímý přístup k instanci ObjectDataSourceView třídy. Vývojáři ovládacího prvku mohou vytvářet vlastní datové ovládací prvky rozšířením ObjectDataSource a ObjectDataSourceView třídami.

Třída ObjectDataSourceView provádí datové operace voláním metod pro obchodní nebo datové objekty pomocí reflexe. V době ObjectDataSource běhu ovládací prvek vytvoří instanci typu, který je identifikován TypeName vlastností, a potom zavolá příslušnou metodu pro operaci dat. Instance objektu není uložena v mezipaměti objektu ObjectDataSourceView. Objekt je vytvořen a zničen pro každé volání metody dat. Pokud je static metoda (Shared v jazyce Visual Basic), instance není vytvořena, ale metoda operace dat je stále volána.

Ovládací ObjectDataSourceView prvek přímo nezobrazuje vývojářům ObjectDataSource stránek. Místo toho jsou vlastnosti a metody ObjectDataSourceView přístupu prostřednictvím ObjectDataSource. DeleteMethod ObjectDataSourceView Například vlastnost je nastavena nastavením DeleteMethod vlastnosti 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 vystaveny přímo jeho ObjectDataSource ovládacím prvkům pro vývojáře stránek a další volající:

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

Aktualizace dat

Objekt ObjectDataSourceView podporuje aktualizace dat voláním metody obchodního nebo datového objektu, která je identifikována UpdateMethod vlastností. Ovládací prvky vázané na data, které automaticky provádějí aktualizace, jako jsou například GridView ovládací prvky a DetailsView ovládací prvky, předávají jejich parametry v IOrderedDictionary rozhraní ObjectDataSourceView 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 ObjectDataSourceView a vystaveny přímo jeho ObjectDataSource ovládacím prvku pro vývojáře stránky a další volající:

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í, jako GridView je například a DetailsView, předávají své parametry v IOrderedDictionary rozhraní ObjectDataSourceView a objekt zobrazení tyto parametry sloučí se všemi parametry, které jsou nalezeny v kolekci InsertParameters .

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

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

Odstranění dat

Objekt ObjectDataSourceView podporuje odstranění dat voláním obchodní nebo datové metody objektu, která je identifikována DeleteMethod vlastností. Ovládací prvky vázané na data, které automaticky provádějí odstranění, jako GridView je například a DetailsView, předávají své parametry v IOrderedDictionary rozhraní ObjectDataSourceView a objekt zobrazení sloučí tyto parametry se všemi parametry nalezenými v kolekci DeleteParameters . Následující metody odstranění, vlastnosti a události jsou implementovány ObjectDataSourceView a vystaveny přímo jeho ObjectDataSource ovládacím prvek stránkovacím vývojářům 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ž můžete data dynamicky filtrovat. Filtrování je podporováno pouze ovládacím ObjectDataSource prvku, pokud Select metoda vrátí DataTable nebo DataSet objekt. Dynamické filtrování pro načítání dat můžete použít pomocí FilterExpression vlastností a FilterParameters jejich vlastností. Tyto vlastnosti jsou implementovány objektem ObjectDataSourceView a vystaveny přímo jeho ObjectDataSource ovládacím prvku ovládacím prvkům vázaným na data a dalším volajícím.

Data, která načtete, ObjectDataSource můžete seřadit tak, že po načtení data v paměti seřadíte. Řazení je podporováno pouze ovládacím ObjectDataSource prvku, pokud Select metoda vrátí DataTable nebo DataSet. Vlastnost CanSort vždy vrátí true, protože ObjectDataSourceView nelze určit, jaký typ je vrácen metodou Select bez volání metody. SortExpression Syntaxe vlastnosti je stejná jako u DataView.Sort 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 , SaveViewStatea TrackViewState metody jsou poskytovány pro povolení zobrazení sledování stavu pro ovládací prvek. Další informace najdete v tématu ASP.NET Přehled správy stavu.

Konstruktory

Name	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Inicializuje novou instanci ObjectDataSourceView třídy.

Vlastnosti

Name	Description
CanDelete	Získá hodnotu určující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje operaci odstranění.
CanInsert	Získá hodnotu určující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje operaci vložení.
CanPage	Získá hodnotu určující, zda ObjectDataSourceView objekt, který je přidružen k aktuálnímu ObjectDataSource ovládacímu prvku podporuje stránkování prostřednictvím načtených dat.
CanRetrieveTotalRowCount	Získá hodnotu urč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 urč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 určující, zda ObjectDataSourceView objekt, který je 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í, když se data v řádku v podkladovém úložišti dat změní v době operace.
ConvertNullToDBNull	Získá nebo nastaví hodnotu určující, zda Parameter hodnoty, které jsou předány do aktualizace, vložení nebo operace odstranění jsou automaticky převedeny z `null` hodnoty Value .
DataObjectTypeName	Získá nebo nastaví název třídy, kterou 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ů obsahující parametry, které jsou používány metodou DeleteMethod .
EnablePaging	Získá nebo nastaví hodnotu určující, zda ovládací prvek zdroje dat podporuje stránkování prostřednictvím sady dat, která načte.
Events	Získá seznam delegátů obslužné rutiny události pro zobrazení zdroje dat. (Zděděno od DataSourceView)
FilterExpression	Získá nebo nastaví filtrovací výraz, který je použit při obchodní objekt metoda, která je identifikována SelectMethod vlastností je volána.
FilterParameters	Získá kolekci parametrů, které jsou přidruženy k libovolným 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á pro vložení dat.
InsertParameters	Získá kolekci parametrů obsahující parametry, které jsou používány metodou InsertMethod .
IsTrackingViewState	Získá hodnotu určující, zda ObjectDataSourceView objekt ukládá změny do jeho 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ů, které se mají načíst 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 použít na názvy parametrů pro původní hodnoty, které jsou předány `Delete` do nebo `Update` metody.
ParsingCulture	Získá nebo nastaví hodnotu, která označuje, jaké jazykové verze informace se používají 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á kolekce 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, kterou ObjectDataSourceView objekt vyvolá k aktualizaci dat.
UpdateParameters	Získá kolekce parametrů obsahující parametry, které jsou používány metodou UpdateMethod .

Metody

Name	Description
CanExecute(String)	Určuje, zda lze zadaný příkaz spustit. (Zděděno od DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Provede asynchronní operaci odstranění v seznamu dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)
Delete(IDictionary, IDictionary)	Provede operaci odstranění voláním metody obchodního objektu, která je identifikována DeleteMethod vlastností pomocí zadaných `keys` a `oldValues` kolekcí.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Spustí zadaný příkaz. (Zděděno od DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Spustí zadaný příkaz. (Zděděno od DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Provede operaci odstranění pomocí DeleteMethod metody a zadané `keys` a `oldValues` kolekce.
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, který je identifikován vlastností TypeName voláním metody, která je identifikována SelectMethod vlastností a předání všech 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 `keys`v , `values`nebo `oldValues` kolekce.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Provede asynchronní operaci vložení v seznamu dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)
Insert(IDictionary)	Provede operaci vložení voláním metody obchodního objektu, která je identifikována InsertMethod vlastností pomocí zadané `values` kolekce.
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení pro zobrazení zdroje dat.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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řed pokusem o ObjectDataSourceView operaci odstranění objektu.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Filtering Vyvolá událost před pokusem objektu ObjectDataSourceView 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 o ObjectDataSourceView operaci vložení.
OnObjectCreated(ObjectDataSourceEventArgs)	ObjectCreated Vyvolá událost po ObjectDataSourceView vytvoření instance objektu, který je identifikován vlastnostíTypeName.
OnObjectCreating(ObjectDataSourceEventArgs)	ObjectCreating Vyvolá událost před objektem ObjectDataSourceView vytvoří instanci obchodního objektu k provedení operace s daty.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	ObjectDisposing Vyvolá událost před objektem ObjectDataSourceView zahodí instance typu.
OnSelected(ObjectDataSourceStatusEventArgs)	Selected Vyvolá událost po ObjectDataSourceView dokončení operace načítání dat.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Selecting Vyvolá událost před pokusem o ObjectDataSourceView 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 ObjectDataSourceView o operaci aktualizace objektu.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Volané metodou RaiseUnsupportedCapabilitiesError(DataSourceView) k porovnání schopností požadovaných pro ExecuteSelect(DataSourceSelectArguments) operaci s funkcemi, které zobrazení podporuje. (Zděděno od DataSourceView)
SaveViewState()	Uloží změny do stavu ObjectDataSourceView zobrazení objektu od doby, kdy byla stránka odeslána zpět na server.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Získá seznam dat asynchronně z podkladového úložiště dat. (Zděděno od DataSourceView)
Select(DataSourceSelectArguments)	Načte data z objektu, který je identifikován vlastností TypeName voláním metody, která je identifikována SelectMethod vlastností a předání všech hodnot v kolekci SelectParameters .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí, že ObjectDataSourceView objekt bude sledovat změny stavu zobrazení, aby změny mohly být uloženy v objektu ViewState pro ovládací prvek a trvale zachovány napříč požadavky na stejnou stránku.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Provede asynchronní aktualizační operaci v seznamu dat, která DataSourceView objekt představuje. (Zděděno od DataSourceView)
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 `keys`v , `values`nebo `oldValues` kolekce.

Událost

Name	Description
DataSourceViewChanged	Nastane, když se změnilo zobrazení zdroje dat. (Zděděno od DataSourceView)
Deleted	Nastane po Delete dokončení operace.
Deleting	Nastane před Delete operací.
Filtering	Nastane před operací filtru.
Inserted	Nastane po Insert dokončení operace.
Inserting	Nastane před Insert operací.
ObjectCreated	Nastane po objektu ObjectDataSourceView vytvoří instanci typu, který je identifikován vlastností TypeName .
ObjectCreating	Nastane před objekt ObjectDataSourceView vytvoří instanci typu, který je identifikován vlastností TypeName .
ObjectDisposing	Nastane, ObjectDataSourceView když objekt zahodí instanci objektu, který vytvořil.
Selected	Nastane, když se dokončí operace načítání dat.
Selecting	Nastane před operací načítání dat.
Updated	Nastane po Update dokončení operace.
Updating	Nastane před Update operací.

Explicitní implementace rozhraní

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

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?