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 určena primárně k použití ovládacími prvky vázanými 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 datové funkce SqlDataSource ovládacího prvku, včetně Selectoperací , Update, Inserta Delete , ř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 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 a SqlDataSourceView 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 můžou měnit, například hodnoty zobrazené v ovládacích prvcích na stránce Web Forms. 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čítání 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, který je 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, který je 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, 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 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, který je přidružen k aktuálnímu SqlDataSource ovládacímu prvku podporuje seřazené zobrazení načtených dat.
CanUpdate	Získá hodnotu označ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 označující, jak SqlDataSource ovládací prvek provádí aktualizace a odstraňuje, 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 označující, zda SqlDataSourceView objekt ukládá změny do svého 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 Update nebo metody.
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 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čtení dat provádí 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

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` a `oldValues` kolekcích.
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` a `oldValues` kolekcích.
ExecuteInsert(IDictionary)	Provede operaci vložení pomocí InsertCommand řetězce SQL, všech parametrů zadaných v kolekci InsertParameters 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 kolekci UpdateParameters , 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()	Získá aktuální Type instanci. (Zděděno od Object)
Insert(IDictionary)	Provede operaci vložení pomocí InsertCommand řetězce SQL, všech parametrů zadaných v kolekci InsertParameters a hodnot, které jsou v zadané `values` kolekci.
Insert(IDictionary, DataSourceViewOperationCallback)	Provede operaci asynchronního vložení v seznamu 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)	Vyvolá událost po Deleted SqlDataSource dokončení operace odstranění ovládacího prvku.
OnDeleting(SqlDataSourceCommandEventArgs)	Vyvolá událost předtí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čítání dat.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Vyvolá událost před tím, než se SqlDataSource ovládací prvek pokusí o operaci načítání dat.
OnUpdated(SqlDataSourceStatusEventArgs)	Updated Vyvolá událost po SqlDataSource dokončení operace aktualizace ovládacího prvku.
OnUpdating(SqlDataSourceCommandEventArgs)	Updating Vyvolá událost předtím, než se SqlDataSource ovládací prvek pokusí o operaci aktualizace.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Porovná možnosti, které jsou požadovány 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 bude sledovat změny stavu zobrazení, aby změny mohly být uloženy v objektu StateBag ovládacího prvku a trvale zachovány v požadavcích na stejnou stránku.
Update(IDictionary, IDictionary, IDictionary)	Provede operaci aktualizace pomocí UpdateCommand řetězce SQL, všech parametrů, které jsou v kolekci UpdateParameters , 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	Nastane při změně 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í filtrování.
Inserted	Nastane po dokončení operace vložení.
Inserting	Nastane před operací vložení.
Selected	Nastane po dokončení 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í

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