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

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

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 možnosti SqlDataSource ovládacího prvku, ke kterému je přidružena, a implementuje základní funkce dat pro ovládací prvek zdroje dat. Třída SqlDataSourceView implementuje funkce dat pro SqlDataSource ovládací prvek, včetně Selectoperací , Update Insert, aDelete, řazení, filtrování a správy nastavení, která se uchovávají ve stavu zobrazení.

SqlDataSourceView I když není objekt přímo zpřístupněn vývojářům stránek ovládacím prvkuSqlDataSource, mnoho jeho vlastností je. 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 položek dat. 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 objektem SqlDataSourceView a zpřístupněny přímo jeho SqlDataSource ovládacím prvku vývojářům stránek 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, například GridView a DetailsView, lze nakonfigurovat tak, aby prováděly aktualizace automaticky pomocí SqlDataSourceViewnástroje , zatímco jiné ovládací prvky ne. Následující metody aktualizace, vlastnosti a události jsou implementovány SqlDataSourceView a zpřístupněny přímo jeho SqlDataSource ovládacím prvek pro vývojáře stránek 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, například GridView a DetailsView, lze nakonfigurovat tak, aby prováděly vkládání automaticky pomocí SqlDataSourceViewnástroje , zatímco jiné ovládací prvky ne. Následující vložené metody, vlastnosti a události jsou implementovány SqlDataSourceView a zpřístupněny přímo jeho SqlDataSource ovládacím prvek 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, například GridView a DetailsView, lze nakonfigurovat tak, aby automaticky prováděly odstranění pomocí SqlDataSourceViewnástroje , zatímco jiné ovládací prvky ne. Následující metody odstranění, vlastnosti a události jsou implementovány SqlDataSourceView a zpřístupněny přímo jeho SqlDataSource ovládacím prvek pro vývojáře stránek a další volající:

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 svázány s hodnotami, které se mohou měnit, například hodnoty, které jsou zobrazeny v ovládacích prvcích na stránce webových formulářů. 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 vlastnosti a FilterParameters k použití dynamického filtrování při načítání dat. Tyto vlastnosti jsou implementovány objektem SqlDataSourceView a jeho ovládacím prvku jsou přímo zpřístupněny ovládacím prvkům SqlDataSource vázaným na data a dalším volajícím.

Data, která načtete pomocí SqlDataSource ovládacího prvku, můžete seřadit 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 řazením dat do paměti po načtení. Můžete zadat výraz řazení nastavením SqlDataSourceView SortExpression vlastnosti objektu DataSourceSelectArguments , který je předán Select metodě. Syntaxe SortExpression vlastnosti je stejná jako syntaxe vlastnosti DataView.Sort . Pokud k načtení dat použijete uloženou proceduru SortParameterName , můžete vlastnost použít také k určení parametru, který se používá speciálně pro řazení výsledků volání uložené procedury.

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

Stejně jako mnoho jiných ovládacích prvků webového SqlDataSourceView IStateManager serveru implementuje rozhraní a používá stav zobrazení ke sledování stavu mezi požadavky na stránku. IsTrackingViewState Implementace vlastnosti a a LoadViewStatemetod , 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

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

CancelSelectOnNullParameter	Získá nebo nastaví hodnotu označující, zda je operace načtení dat zrušena, když se jakýkoli parametr obsažený v kolekci SelectParameters vyhodnotí jako `null`.
CanDelete	Získá hodnotu označující, zda SqlDataSourceView objekt přidružený k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci odstranění.
CanInsert	Získá hodnotu označující, zda SqlDataSourceView objekt přidružený k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci vložení.
CanPage	Získá hodnotu označující, zda SqlDataSourceView objekt přidružený k aktuálnímu SqlDataSource ovládacímu prvku podporuje stránkování načtených dat.
CanRetrieveTotalRowCount	Získá hodnotu označ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 označující, zda SqlDataSourceView objekt 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 označující, zda SqlDataSourceView objekt přidružený k aktuálnímu SqlDataSource ovládacímu prvku podporuje operaci aktualizace.
ConflictDetection	Získá nebo nastaví hodnotu označující, jak SqlDataSource ovládací prvek provádí aktualizace a odstranění, když se data v řádku v podkladové databázi změní během 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 označující, zda text ve DeleteCommand vlastnosti je příkaz jazyka 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álostí 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 označující, zda text ve InsertCommand vlastnosti je příkaz jazyka 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 označující, zda SqlDataSourceView objekt ukládá změny do stavu zobrazení.
Name	Získá název zobrazení zdroje dat. (Zděděno od DataSourceView)
OldValuesParameterFormatString	Získá nebo nastaví formátovací řetězec, který se použije na názvy všech parametrů, které jsou předány metodě Delete nebo Update .
ParameterPrefix	Získá řetězec, který se používá k předponu 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 označ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čtení dat je provedeno 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 označující, zda text ve UpdateCommand vlastnosti je příkaz jazyka SQL nebo název uložené procedury.
UpdateParameters	Získá kolekci parametrů obsahující parametry, které jsou používány UpdateCommand vlastností .

Metody

CanExecute(String)	Určuje, zda lze provést zadaný příkaz. (Zděděno od DataSourceView)
Delete(IDictionary, IDictionary)	Provede operaci odstranění pomocí DeleteCommand řetězce SQL, všech parametrů zadaných v kolekci DeleteParameters a hodnot, které jsou v zadaných `keys` kolekcích 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í DeleteCommand řetězce SQL, všech parametrů zadaných v kolekci DeleteParameters a hodnot, které jsou v zadaných `keys` kolekcích a `oldValues` .
ExecuteInsert(IDictionary)	Provede operaci vložení pomocí InsertCommand řetězce SQL, všechny parametry zadané v kolekci InsertParameters a hodnoty, 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ých `keys`kolekcích , `values`a `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í pomocí InsertCommand řetězce SQL, všechny parametry zadané v kolekci InsertParameters a hodnoty, které jsou v zadané `values` kolekci.
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(SqlDataSourceStatusEventArgs)	Deleted Vyvolá událost po SqlDataSource dokončení operace odstranění ovládacího prvku.
OnDeleting(SqlDataSourceCommandEventArgs)	Vyvolá událost před tím, Deleting než se SqlDataSource ovládací prvek pokusí o operaci odstranění.
OnFiltering(SqlDataSourceFilteringEventArgs)	Filtering Vyvolá událost před tím, než SqlDataSource ovládací prvek filtruje výsledky operace výběru.
OnInserted(SqlDataSourceStatusEventArgs)	Inserted Vyvolá událost po SqlDataSource dokončení operace vložení ovládacího prvku.
OnInserting(SqlDataSourceCommandEventArgs)	Inserting Vyvolá událost před tím, než se SqlDataSource ovládací prvek pokusí o operaci vložení.
OnSelected(SqlDataSourceStatusEventArgs)	Selected Vyvolá událost poté, SqlDataSource co ovládací prvek dokončil operaci načtení dat.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Vyvolá událost před tím, než se SqlDataSource ovládací prvek pokusí 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 požadované pro ExecuteSelect(DataSourceSelectArguments) operaci s možnostmi, které zobrazení podporuje a je volána metodou RaiseUnsupportedCapabilitiesError(DataSourceView) .
SaveViewState()	Uloží změny stavu SqlDataSourceView zobrazení ovládacího prvku od okamžiku, kdy byla stránka odeslána zpět na server.
Select(DataSourceSelectArguments)	Načte data z podkladové databáze pomocí SelectCommand řetězce SQL a všech parametrů, které jsou 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í, SqlDataSourceView že objekt sleduje změny stavu zobrazení tak, aby změny mohly být uloženy v objektu StateBag ovládacího prvku a trvalé mezi požadavky na stejnou stránku.
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ých `keys`kolekcích , `values`a `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 dokončení operace odstranění.
Deleting	Nastane před operací odstranění.
Filtering	Nastane před operací filtrování.
Inserted	Vyvolá se po dokončení operace vložení.
Inserting	Nastane před operací vložení.
Selected	Vyvolá se po dokončení operace načtení dat.
Selecting	Nastane před operací načtení dat.
Updated	Vyvolá se po dokončení operace aktualizace.
Updating	Nastane před operací aktualizace.

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

Sdílet prostřednictvím