SqlDataSourceView Třída
Definice
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
- Odvozené
- Implementuje
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í , UpdateInsert, 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 SqlDataSourceViewSortExpression 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 SqlDataSourceViewIStateManager 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 |
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 |
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 |
ExecuteInsert(IDictionary) |
Provede operaci vložení pomocí InsertCommand řetězce SQL, všechny parametry zadané v kolekci InsertParameters a hodnoty, které jsou v zadané |
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 |
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é |
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 |
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(). |