Sdílet prostřednictvím


SqlDataSourceView Třída

Definice

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
SqlDataSourceView
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:

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í:

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í:

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í:

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

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í 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 keyskolekcích , valuesa 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í pomocí InsertCommand řetězce SQL, všechny parametry zadané v kolekci InsertParameters a hodnoty, 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 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, 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í, 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, DataSourceViewOperationCallback)

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

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

Viz také