Sdílet prostřednictvím


ObjectDataSourceView Třída

Definice

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
ObjectDataSourceView
Implementuje

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í , UpdateDelete, 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ů můžou vytvářet vlastní ovládací prvky dat rozšířením ObjectDataSource tříd a ObjectDataSourceView .

Třída ObjectDataSourceView provádí operace s daty voláním metod na obchodních nebo datových objektech pomocí reflexe. Za běhu ovládací prvek vytvoří instanci typu, ObjectDataSource který je identifikován TypeName vlastností, a pak zavolá příslušnou metodu pro operaci dat. Objekt instance není uložen v mezipaměti objektem 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 dat je stále volána.

Ovládací ObjectDataSourceView prvek 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 objektu ObjectDataSource. Například DeleteMethod vlastnost of ObjectDataSourceView 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 zpřístupněny přímo jeho ObjectDataSource ovládacím prvku vývojářům stránek a dalším volajícím:

Aktualizace dat

Objekt ObjectDataSourceView podporuje aktualizace dat voláním obchodní nebo datové metody 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í do 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 ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvek pro vývojáře stránek a další volající:

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

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

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í, například GridView a , předávají své parametry v IOrderedDictionary rozhraní objektu ObjectDataSourceView a objekt zobrazení tyto parametry sloučí se všemi parametry, které se nacházejí v kolekci DeleteParametersDetailsView. Následující metody odstranění, vlastnosti a události jsou implementovány ObjectDataSourceView a zpřístupněny přímo jeho ObjectDataSource ovládacím prvek pro vývojáře stránek a další volající:

Filtrování a řazení dat

Načítání dat je výkonnější, když můžete data filtrovat dynamicky. Filtrování je podporováno pouze ovládacím prvku, ObjectDataSource pokud Select metoda vrátí 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ým na data a dalším volajícím.

Data, která načítáte, můžete seřadit pomocí ObjectDataSource pořadí dat v paměti po jejich načtení. Řazení podporuje pouze ovládací prvek, ObjectDataSource pokud Select metoda vrátí DataTable nebo DataSet. Vlastnost CanSort vždy vrátí true, protože ObjectDataSourceView nemůže určit, jaký typ vrátí Select metoda bez volání metody. Syntaxe SortExpression vlastnosti je stejná jako u DataView.Sort vlastnosti.

Sledování stavu zobrazení

Implementuje ObjectDataSourceViewIStateManager rozhraní a používá stav zobrazení ke sledování jeho stavu napříč požadavky na stránku. 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, DataSourceViewOperationCallback)

Provede asynchronní operaci odstranění 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 identifikovaná DeleteMethod vlastností pomocí zadaných keys kolekcí a oldValues .

Equals(Object)

Určí, zda se zadaný objekt rovná 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 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 keyskolekcích , valuesnebo 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, DataSourceViewOperationCallback)

Provede asynchronní vkládání operace se seznamem 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 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, 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 identifikovaného TypeName vlastností zavoláním metody, která je identifikovaná SelectMethod vlastností a předáním hodnot v kolekci SelectParameters .

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, DataSourceViewOperationCallback)

Provede asynchronní operaci aktualizace 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 v keyskolekcích , valuesnebo oldValues .

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

Viz také