SqlDataSourceView 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í.

SqlDataSource Podporuje ovládací prvek a poskytuje rozhraní pro ovládací prvky vázané na data k provádění operací s daty SQL s relačními databázemi.

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

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

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Dědičnost: Object

DataSourceView
SqlDataSourceView

Odvozené: System.Web.UI.WebControls.AccessDataSourceView

Implementuje: IStateManager

Poznámky

Třída SqlDataSourceView 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.

ASP.NET ovládací prvky zdroje dat obsahují jeden nebo více seznamů dat reprezentovaných objekty zobrazení zdroje dat. Třída SqlDataSourceView rozšiřuje DataSourceView třídu, definuje schopnosti SqlDataSource ovládacího prvku, ke kterému je přidružen, a implementuje základní funkce dat pro správu zdroje dat. Třída SqlDataSourceView implementuje funkce dat pro SqlDataSource ovládací prvek, včetně Select, Update, Inserta Delete operací, řazení, filtrování a správy nastavení, které jsou zachovány ve stavu zobrazení.

SqlDataSourceView I když objekt není přímo zpřístupněn vývojářům stránek ovládacím SqlDataSource prvku, mnohé z jeho vlastností jsou. Nejzákladnější operací, kterou zobrazení zdroje dat provádí, je načtení dat z podkladové databáze pomocí Select metody, která načte IEnumerable kolekci datových položek. Třída SqlDataSourceView implementuje načítání dat z relačních databází pomocí dotazů SQL. Dotazy SQL je možné parametrizovat pro větší flexibilitu a zabezpečení. Následující metody načítání dat, vlastnosti a události jsou implementovány SqlDataSourceView a vystaveny přímo jeho SqlDataSource ovládacím prvek stránkovacím vývojářům a dalším volajícím:

Vlastnost SelectCommand
Vlastnost SelectParameters
Událost Selecting
Událost Selected

Objekt SqlDataSourceView podporuje aktualizaci dat v relační databázi pomocí příkazů SQL. Příkazy SQL je možné parametrizovat pro větší flexibilitu a zabezpečení. Ovládací prvky vázané na data, jako je například a GridView DetailsView, lze nakonfigurovat tak, aby automaticky prováděly aktualizace pomocí ovládacích SqlDataSourceViewprvků, zatímco jiné ovládací prvky nemohou. Následující metody aktualizace, vlastnosti a události jsou implementovány SqlDataSourceView a vystaveny přímo jeho SqlDataSource ovládacím prvku pro vývojáře stránky a další volající:

Vlastnost UpdateCommand
Vlastnost UpdateParameters
Událost Updating
Událost Updated

Podporuje SqlDataSourceView vkládání nových řádků dat do relační databáze. Příkazy SQL zadané ve InsertCommand vlastnosti lze parametrizovat pro větší flexibilitu a zabezpečení. Ovládací prvky vázané na data, jako je například a GridView DetailsView, lze nakonfigurovat tak, aby prováděly vkládání automaticky pomocí ovládacích SqlDataSourceViewprvků , zatímco jiné ovládací prvky nemohou. Následující metody vložení, vlastnosti a události jsou implementovány SqlDataSourceView a vystaveny přímo jeho SqlDataSource ovládacím prvkům pro vývojáře stránek a další volající:

Vlastnost InsertCommand
Vlastnost InsertParameters
Událost Inserting
Událost Inserted

Objekt SqlDataSourceView také podporuje odstranění dat z relační databáze. Stejně jako u jiných příkazů lze příkazy SQL zadané ve DeleteCommand vlastnosti parametrizovat pro větší flexibilitu a zabezpečení. Ovládací prvky vázané na data, jako je například a GridView DetailsView, lze nakonfigurovat tak, aby prováděly odstranění automaticky pomocí ovládacích SqlDataSourceViewprvků , zatímco jiné ovládací prvky nemohou. Následující metody odstranění, vlastnosti a události jsou implementovány SqlDataSourceView a vystaveny přímo jeho SqlDataSource ovládacím prvek stránkovacím vývojářům a dalším volajícím:

Vlastnost DeleteCommand
Vlastnost DeleteParameters
Událost Deleting
Událost Deleted

Načítání dat je výkonnější, když je dynamická klauzule, která se používá k filtrování dat během načítání dat. Jinými slovy, dotaz SQL se statickou klauzulí WHERE není tak flexibilní a výkonný jako dotaz SQL, kde jsou hodnoty v klauzuli WHERE vázány na hodnoty, které se mohou změnit, například hodnoty zobrazené v ovládacích prvcích na stránce Webové formuláře. Místo opětovného sestavení dotazu SQL a nastavení SelectCommand vlastnosti při každém načtení stránky můžete použít FilterExpression dynamické FilterParameters filtrování pro načtení dat. Tyto vlastnosti jsou implementovány SqlDataSourceView a vystaveny přímo jeho SqlDataSource ovládacím prvku pro ovládací prvky vázané na data a další volající.

Data, která načítáte, můžete seřadit pomocí SqlDataSource ovládacího prvku přidáním klauzule ORDER BY, která způsobí, že databáze provede řazení za vás při načítání dat nebo seřazením dat v paměti po načtení. Výraz SqlDataSourceView řazení můžete zadat nastavením SortExpression vlastnosti objektu DataSourceSelectArguments , který je předán metodě Select . Syntaxe vlastnosti SortExpression je stejná jako syntaxe vlastnosti DataView.Sort . Pokud k načtení dat použijete uloženou proceduru, můžete také použít SortParameterName vlastnost k určení parametru, který se používá speciálně pro řazení výsledků volání uložené procedury.

Pokud databázi může současně změnit více než jeden uživatel, může dojít ke konfliktu souběžnosti. Ovládací SqlDataSource prvek má ovládací prvky souběžnosti prostřednictvím SqlDataSource.ConflictDetection vlastnosti. Funkce je implementována SqlDataSourceView.ConflictDetection ve vlastnosti.

Stejně jako mnoho dalších ovládacích prvků SqlDataSourceView webového serveru implementuje IStateManager rozhraní a používá stav zobrazení ke sledování jeho stavu napříč požadavky stránky. IsTrackingViewState Implementace a vlastnosti a LoadViewState SaveViewState, a TrackViewState metody jsou k dispozici 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
SqlDataSourceView(SqlDataSource, String, HttpContext)	Inicializuje novou instanci SqlDataSourceView třídy nastavení zadaného SqlDataSource ovládacího prvku jako vlastníka aktuálního zobrazení.

Vlastnosti

Name	Description
CancelSelectOnNullParameter	Získá nebo nastaví hodnotu určující, zda je operace načítání dat zrušena, když se vyhodnotí jakýkoli parametr obsažený v SelectParameters kolekci `null`.
CanDelete	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci odstranění.
CanInsert	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci vložení.
CanPage	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje stránkování načtených dat.
CanRetrieveTotalRowCount	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje načtení celkového počtu řádků dat kromě sady dat.
CanSort	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje seřazené zobrazení na načtených datech.
CanUpdate	Získá hodnotu určující, zda SqlDataSourceView objekt, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci aktualizace.
ConflictDetection	Získá nebo nastaví hodnotu určující, jak SqlDataSource ovládací prvek provádí aktualizace a odstraní, když se data v řádku v podkladové databázi změní v době operace.
DeleteCommand	Získá nebo nastaví řetězec SQL, který SqlDataSourceView používá k odstranění dat z podkladové databáze.
DeleteCommandType	Získá nebo nastaví hodnotu určující, zda text ve DeleteCommand vlastnosti je příkaz SQL nebo název uložené procedury.
DeleteParameters	Získá kolekci parametrů obsahující parametry, které jsou používány DeleteCommand vlastností.
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ý se použije při Select zavolání metody.
FilterParameters	Získá kolekci parametrů, které jsou přidruženy k libovolným zástupným symbolům parametrů v řetězci FilterExpression .
InsertCommand	Získá nebo nastaví řetězec SQL, který SqlDataSourceView objekt používá k vložení dat do podkladové databáze.
InsertCommandType	Získá nebo nastaví hodnotu určující, zda text ve InsertCommand vlastnosti je příkaz SQL nebo název uložené procedury.
InsertParameters	Získá kolekci parametrů obsahující parametry, které jsou používány InsertCommand vlastností.
IsTrackingViewState	Získá hodnotu určující, zda SqlDataSourceView objekt ukládá změny do jeho stavu zobrazení.
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 všech parametrů, které jsou předány Delete do nebo Update metody.
ParameterPrefix	Získá řetězec, který se používá k předponě zástupného symbolu parametru v parametrizovaném dotazu SQL.
SelectCommand	Získá nebo nastaví řetězec SQL, který SqlDataSourceView objekt používá k načtení dat z podkladové databáze.
SelectCommandType	Získá nebo nastaví hodnotu určující, zda text ve SelectCommand vlastnosti je dotaz SQL nebo název uložené procedury.
SelectParameters	Získá kolekci parametrů obsahující parametry, které jsou používány SelectCommand vlastností.
SortParameterName	Získá nebo nastaví název parametru uložené procedury, který se používá k řazení načtených dat při načítání dat pomocí uložené procedury.
UpdateCommand	Získá nebo nastaví řetězec SQL, který SqlDataSourceView objekt používá k aktualizaci dat v podkladové databázi.
UpdateCommandType	Získá nebo nastaví hodnotu určující, zda text ve UpdateCommand vlastnosti je příkaz SQL nebo název uložené procedury.
UpdateParameters	Získá kolekci parametrů obsahující parametry, které jsou používány UpdateCommand vlastností.

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í pomocí DeleteCommand řetězce SQL, všech parametrů zadaných v DeleteParameters kolekci a hodnot, které jsou v zadaných `keys` a `oldValues` kolekcích.
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í DeleteCommand řetězce SQL, všech parametrů zadaných v DeleteParameters kolekci a hodnot, které jsou v zadaných `keys` a `oldValues` kolekcích.
ExecuteInsert(IDictionary)	Provede operaci vložení pomocí InsertCommand řetězce SQL, všech parametrů zadaných v InsertParameters kolekci a hodnot, které jsou v zadané `values` kolekci.
ExecuteSelect(DataSourceSelectArguments)	Načte data z podkladové databáze pomocí SelectCommand řetězce SQL a všech parametrů, které jsou v kolekci SelectParameters .
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Provede operaci aktualizace pomocí UpdateCommand řetězce SQL, všech parametrů, které jsou v UpdateParameters kolekci, a hodnot, které jsou v zadaném `keys`objektu , `values`a `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í pomocí InsertCommand řetězce SQL, všech parametrů zadaných v InsertParameters kolekci a hodnot, které jsou v zadané `values` kolekci.
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(SqlDataSourceStatusEventArgs)	Deleted Vyvolá událost po SqlDataSource dokončení operace odstranění ovládacího prvku.
OnDeleting(SqlDataSourceCommandEventArgs)	Deleting Vyvolá událost před pokusem SqlDataSource o operaci odstranění.
OnFiltering(SqlDataSourceFilteringEventArgs)	Vyvolá událost před tím, než SqlDataSource ovládací prvek vyfiltruje Filtering výsledky výběrové operace.
OnInserted(SqlDataSourceStatusEventArgs)	Inserted Vyvolá událost po SqlDataSource dokončení operace vložení.
OnInserting(SqlDataSourceCommandEventArgs)	Inserting Vyvolá událost před pokusem SqlDataSource ovládacího prvku o operaci vložení.
OnSelected(SqlDataSourceStatusEventArgs)	Selected Vyvolá událost poté, co SqlDataSource ovládací prvek dokončí operaci načítání dat.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Vyvolá událost před pokusem SqlDataSource ovládacího prvku o operaci načtení dat.
OnUpdated(SqlDataSourceStatusEventArgs)	Updated Vyvolá událost po SqlDataSource dokončení operace aktualizace ovládacího prvku.
OnUpdating(SqlDataSourceCommandEventArgs)	Updating Vyvolá událost před pokusem SqlDataSource ovládacího prvku o operaci aktualizace.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Porovná možnosti, které jsou požadovány pro ExecuteSelect(DataSourceSelectArguments) operaci s funkcemi, které zobrazení podporuje a je volána metodou RaiseUnsupportedCapabilitiesError(DataSourceView) .
SaveViewState()	Uloží změny do stavu SqlDataSourceView zobrazení ovládacího prvku 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 podkladové databáze pomocí SelectCommand řetězce SQL a všech parametrů, které jsou v kolekci SelectParameters .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí, že SqlDataSourceView objekt bude sledovat změny stavu zobrazení, aby změny mohly být uloženy v objektu StateBag 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 pomocí UpdateCommand řetězce SQL, všech parametrů, které jsou v UpdateParameters kolekci, a hodnot, které jsou v zadaném `keys`objektu , `values`a `oldValues` kolekce.

Událost

Name	Description
DataSourceViewChanged	Nastane, když se změnilo zobrazení zdroje dat. (Zděděno od DataSourceView)
Deleted	Nastane po dokončení operace odstranění.
Deleting	Nastane před operací odstranění.
Filtering	Nastane před operací filtru.
Inserted	Nastane po dokončení operace vložení.
Inserting	Nastane před operací vložení.
Selected	Nastane, když se dokončí operace načítání dat.
Selecting	Nastane před operací načítání dat.
Updated	Nastane po dokončení operace aktualizace.
Updating	Nastane před operací aktualizace.

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á?