SqlDataSourceView Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Obsługuje kontrolkę SqlDataSource i udostępnia interfejs kontrolek powiązanych z danymi w celu wykonywania operacji danych SQL na relacyjnych bazach danych.

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

Dziedziczenie: Object

DataSourceView
SqlDataSourceView

Pochodne: System.Web.UI.WebControls.AccessDataSourceView

Implementuje: IStateManager

Uwagi

Klasa SqlDataSourceView ma być używana głównie przez kontrolki powiązane z danymi, a nie jako obiekt programowalny w kodzie strony.

ASP.NET kontrolki źródła danych zawierają co najmniej jedną listę danych reprezentowanych przez obiekty widoku źródła danych. Klasa SqlDataSourceView rozszerza klasę DataSourceView , definiuje możliwości kontrolki SqlDataSource , z którą jest skojarzona, i implementuje podstawowe funkcje danych dla kontroli źródła danych. Klasa SqlDataSourceView implementuje funkcje danych dla SqlDataSource kontrolki, w tym Selectoperacje , Update, Inserti Delete , sortowanie, filtrowanie i zarządzanie ustawieniami, które są przechowywane w stanie widoku.

SqlDataSourceView Mimo że obiekt nie jest bezpośrednio udostępniany deweloperom stron przez kontrolkęSqlDataSource, wiele z jego właściwości jest. Najbardziej podstawową operacją wykonywaną przez widok źródła danych jest pobieranie danych z bazowej bazy danych przy użyciu Select metody , która pobiera IEnumerable kolekcję elementów danych. Klasa SqlDataSourceView implementuje pobieranie danych z relacyjnych baz danych przy użyciu zapytań SQL. Zapytania SQL można sparametryzować, aby uzyskać większą elastyczność i bezpieczeństwo. Następujące metody pobierania danych, właściwości i zdarzenia są implementowane przez SqlDataSourceView element i udostępniane bezpośrednio przez kontrolkę SqlDataSource deweloperom stron i innym obiektom wywołującym:

Właściwość SelectCommand
Właściwość SelectParameters
Zdarzenie Selecting
Zdarzenie Selected

Obiekt SqlDataSourceView obsługuje aktualizowanie danych w relacyjnej bazie danych przy użyciu poleceń SQL. Polecenia SQL można sparametryzować w celu zwiększenia elastyczności i zabezpieczeń. Kontrolki powiązane z danymi, takie jak GridView i DetailsView, można skonfigurować do automatycznego wykonywania aktualizacji przy użyciu elementu SqlDataSourceView, podczas gdy inne kontrolki nie mogą. Następujące metody aktualizacji, właściwości i zdarzenia są implementowane przez SqlDataSourceView element i udostępniane bezpośrednio przez jego SqlDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Właściwość UpdateCommand
Właściwość UpdateParameters
Zdarzenie Updating
Zdarzenie Updated

Program SqlDataSourceView obsługuje wstawianie nowych wierszy danych do relacyjnej bazy danych. Polecenia SQL określone we InsertCommand właściwości można sparametryzować, aby zapewnić większą elastyczność i bezpieczeństwo. Kontrolki powiązane z danymi, takie jak GridView i DetailsView, można skonfigurować do automatycznego wstawiania przy użyciu SqlDataSourceViewelementu , podczas gdy inne kontrolki nie mogą. Następujące metody wstawiania, właściwości i zdarzenia są implementowane przez SqlDataSourceView element i udostępniane bezpośrednio przez jego SqlDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Właściwość InsertCommand
Właściwość InsertParameters
Zdarzenie Inserting
Zdarzenie Inserted

Obiekt SqlDataSourceView obsługuje również usuwanie danych z relacyjnej bazy danych. Podobnie jak w przypadku innych poleceń, polecenia SQL określone we DeleteCommand właściwości można sparametryzować w celu zwiększenia elastyczności i bezpieczeństwa. Kontrolki powiązane z danymi, takie jak GridView i DetailsView, można skonfigurować do automatycznego wykonywania usuwania przy użyciu kontrolki SqlDataSourceView, podczas gdy inne kontrolki nie mogą. Następujące metody usuwania, właściwości i zdarzenia są implementowane przez SqlDataSourceView element i udostępniane bezpośrednio przez jego SqlDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Właściwość DeleteCommand
Właściwość DeleteParameters
Zdarzenie Deleting
Zdarzenie Deleted

Pobieranie danych jest bardziej zaawansowane, gdy klauzula używana do filtrowania danych podczas pobierania danych jest dynamiczna. Innymi słowy zapytanie SQL ze statyczną klauzulą WHERE nie jest tak elastyczne i zaawansowane, jak zapytanie SQL, w którym wartości w klauzuli WHERE są powiązane z wartościami, które mogą ulec zmianie, takie jak wartości wyświetlane w kontrolkach na stronie Web Forms. Zamiast ponownie kompilować zapytanie SQL i ustawiać SelectCommand właściwość na każdym ładowaniu strony, możesz użyć FilterExpression właściwości i FilterParameters , aby zastosować filtrowanie dynamiczne do pobierania danych. Te właściwości są implementowane przez kontrolkę SqlDataSourceView i uwidocznione bezpośrednio przez kontrolki SqlDataSource powiązane z danymi i inne osoby wywołujące.

Dane pobierane za SqlDataSource pomocą kontrolki można sortować, dodając klauzulę ORDER BY, co powoduje, że baza danych wykonuje kolejność podczas pobierania danych lub porządkowając dane w pamięci po ich pobraniu. Możesz podać wyrażenie sortowania do SqlDataSourceView obiektu, ustawiając SortExpression właściwość DataSourceSelectArguments obiektu przekazanego Select do metody. Składnia właściwości SortExpression jest taka sama jak składnia właściwości DataView.Sort . Jeśli używasz procedury składowanej do pobierania danych, możesz również użyć SortParameterName właściwości , aby określić parametr, który jest używany specjalnie do sortowania wyników wywołania procedury składowanej.

Jeśli więcej niż jeden użytkownik może jednocześnie zmienić bazę danych, istnieje możliwość konfliktu współbieżności. Kontrolka SqlDataSource ma kontrolki współbieżności za pośrednictwem SqlDataSource.ConflictDetection właściwości. Funkcjonalność jest implementowana we SqlDataSourceView.ConflictDetection właściwości .

Podobnie jak wiele innych kontrolek serwera sieci Web, SqlDataSourceView implementuje IStateManager interfejs i używa stanu widoku do śledzenia stanu między żądaniami stron. Implementacje IsTrackingViewState właściwości i oraz LoadViewStatemetody , SaveViewStatei są TrackViewState udostępniane w celu włączenia śledzenia stanu widoku dla kontrolki. Aby uzyskać więcej informacji, zobacz ASP.NET State Management Overview (Omówienie zarządzania stanami ASP.NET).

Konstruktory

SqlDataSourceView(SqlDataSource, String, HttpContext)

Inicjuje SqlDataSourceView nowe wystąpienie klasy, ustawiając określoną SqlDataSource kontrolkę jako właściciela bieżącego widoku.

Właściwości

CancelSelectOnNullParameter	Pobiera lub ustawia wartość wskazującą, czy operacja pobierania danych jest anulowana, gdy dowolny parametr zawarty w SelectParameters kolekcji daje `null`w wyniku wartość .
CanDelete	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje operację usuwania.
CanInsert	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje operację wstawiania.
CanPage	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje stronicowanie pobranych danych.
CanRetrieveTotalRowCount	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje pobieranie całkowitej liczby wierszy danych oprócz zestawu danych.
CanSort	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje posortowany widok pobranych danych.
CanUpdate	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt skojarzony z bieżącą SqlDataSource kontrolką obsługuje operację aktualizacji.
ConflictDetection	Pobiera lub ustawia wartość wskazującą, jak kontrolka SqlDataSource wykonuje aktualizacje i usuwa, gdy dane w wierszu w bazowej bazie danych zmieniają się w czasie operacji.
DeleteCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSourceView do usuwania danych z bazowej bazy danych.
DeleteCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we DeleteCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
DeleteParameters	Pobiera kolekcję parametrów zawierającą DeleteCommand parametry, które są używane przez właściwość .
Events	Pobiera listę delegatów procedury obsługi zdarzeń dla widoku źródła danych. (Odziedziczone po DataSourceView)
FilterExpression	Pobiera lub ustawia wyrażenie filtrowania, które jest stosowane po wywołaniu Select metody.
FilterParameters	Pobiera kolekcję parametrów skojarzonych z dowolnymi symbolami zastępczymi parametrów w FilterExpression ciągu.
InsertCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSourceView przez obiekt do wstawiania danych do bazowej bazy danych.
InsertCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we InsertCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
InsertParameters	Pobiera kolekcję parametrów zawierającą InsertCommand parametry, które są używane przez właściwość .
IsTrackingViewState	Pobiera wartość wskazującą, czy SqlDataSourceView obiekt zapisuje zmiany w stanie widoku.
Name	Pobiera nazwę widoku źródła danych. (Odziedziczone po DataSourceView)
OldValuesParameterFormatString	Pobiera lub ustawia ciąg formatu, który ma być stosowany do nazw wszystkich parametrów przekazywanych do Delete metody or Update .
ParameterPrefix	Pobiera ciąg używany do prefiksu symbolu zastępczego parametru w sparametryzowanym zapytaniu SQL.
SelectCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSourceView przez obiekt do pobierania danych z bazowej bazy danych.
SelectCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we SelectCommand właściwości jest zapytaniem SQL, czy nazwą procedury składowanej.
SelectParameters	Pobiera kolekcję parametrów zawierającą SelectCommand parametry, które są używane przez właściwość .
SortParameterName	Pobiera lub ustawia nazwę parametru procedury składowanej używanego do sortowania pobranych danych podczas pobierania danych przy użyciu procedury składowanej.
UpdateCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSourceView przez obiekt do aktualizowania danych w bazowej bazie danych.
UpdateCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we UpdateCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
UpdateParameters	Pobiera kolekcję parametrów zawierającą UpdateCommand parametry, które są używane przez właściwość .

Metody

CanExecute(String)	Określa, czy można wykonać określone polecenie. (Odziedziczone po DataSourceView)
Delete(IDictionary, IDictionary)	Wykonuje operację usuwania przy użyciu DeleteCommand ciągu SQL, wszystkich parametrów określonych w DeleteParameters kolekcji oraz wartości, które znajdują się w określonych `keys` kolekcjach i `oldValues` .
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Wykonuje asynchroniczną operację usuwania na liście danych reprezentowanych przez DataSourceView obiekt. (Odziedziczone po DataSourceView)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExecuteCommand(String, IDictionary, IDictionary)	Wykonuje określone polecenie. (Odziedziczone po DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Wykonuje określone polecenie. (Odziedziczone po DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Wykonuje operację usuwania przy użyciu DeleteCommand ciągu SQL, wszystkich parametrów określonych w DeleteParameters kolekcji oraz wartości, które znajdują się w określonych `keys` kolekcjach i `oldValues` .
ExecuteInsert(IDictionary)	Wykonuje operację wstawiania przy użyciu InsertCommand ciągu SQL, wszystkich parametrów określonych w InsertParameters kolekcji i wartości, które znajdują się w określonej `values` kolekcji.
ExecuteSelect(DataSourceSelectArguments)	Pobiera dane z bazowej bazy danych przy użyciu SelectCommand ciągu SQL i wszystkich parametrów, które znajdują się w kolekcji SelectParameters .
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Wykonuje operację aktualizacji przy użyciu UpdateCommand ciągu SQL, wszystkich parametrów w UpdateParameters kolekcji oraz wartości, które znajdują się w określonych `keys`kolekcjach , `values`i `oldValues` .
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Insert(IDictionary)	Wykonuje operację wstawiania przy użyciu InsertCommand ciągu SQL, wszystkich parametrów określonych w InsertParameters kolekcji i wartości, które znajdują się w określonej `values` kolekcji.
Insert(IDictionary, DataSourceViewOperationCallback)	Wykonuje operację asynchronicznego wstawiania na liście danych reprezentowanych przez DataSourceView obiekt. (Odziedziczone po DataSourceView)
LoadViewState(Object)	Przywraca poprzednio zapisany stan widoku dla widoku źródła danych.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDataSourceViewChanged(EventArgs)	DataSourceViewChanged Zgłasza zdarzenie. (Odziedziczone po DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Zgłasza zdarzenie po zakończeniu Deleted SqlDataSource operacji usuwania kontrolki.
OnDeleting(SqlDataSourceCommandEventArgs)	Deleting Wywołuje zdarzenie przed podjęciem SqlDataSource próby usunięcia przez kontrolkę.
OnFiltering(SqlDataSourceFilteringEventArgs)	Filtering Wywołuje zdarzenie, zanim SqlDataSource kontrolka filtruje wyniki operacji wybierania.
OnInserted(SqlDataSourceStatusEventArgs)	Zgłasza zdarzenie po zakończeniu Inserted SqlDataSource operacji wstawiania kontrolki.
OnInserting(SqlDataSourceCommandEventArgs)	Inserting Wywołuje zdarzenie przed podjęciem SqlDataSource próby wykonania operacji wstawiania przez kontrolkę.
OnSelected(SqlDataSourceStatusEventArgs)	Zgłasza zdarzenie po zakończeniu Selected SqlDataSource operacji pobierania danych przez kontrolkę.
OnSelecting(SqlDataSourceSelectingEventArgs)	Selecting Wywołuje zdarzenie przed podjęciem SqlDataSource próby pobrania danych przez kontrolkę.
OnUpdated(SqlDataSourceStatusEventArgs)	Zgłasza zdarzenie po zakończeniu Updated SqlDataSource operacji aktualizacji kontrolki.
OnUpdating(SqlDataSourceCommandEventArgs)	Updating Wywołuje zdarzenie, zanim kontrolka SqlDataSource podejmie próbę wykonania operacji aktualizacji.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Porównuje możliwości, które są żądane dla ExecuteSelect(DataSourceSelectArguments) operacji względem tych, które obsługuje widok i jest wywoływany przez metodę RaiseUnsupportedCapabilitiesError(DataSourceView) .
SaveViewState()	Zapisuje zmiany stanu widoku dla kontrolki SqlDataSourceView od czasu opublikowania strony z powrotem na serwerze.
Select(DataSourceSelectArguments)	Pobiera dane z bazowej bazy danych przy użyciu SelectCommand ciągu SQL i wszystkich parametrów, które znajdują się w kolekcji SelectParameters .
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Pobiera listę danych asynchronicznie z bazowego magazynu danych. (Odziedziczone po DataSourceView)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	SqlDataSourceView Powoduje, że obiekt będzie śledzić zmiany stanu widoku, dzięki czemu zmiany mogą być przechowywane w StateBag obiekcie dla kontrolki i utrwalane w żądaniach dla tej samej strony.
Update(IDictionary, IDictionary, IDictionary)	Wykonuje operację aktualizacji przy użyciu UpdateCommand ciągu SQL, wszystkich parametrów w UpdateParameters kolekcji oraz wartości, które znajdują się w określonych `keys`kolekcjach , `values`i `oldValues` .
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Wykonuje asynchroniczną operację aktualizacji na liście danych reprezentowanych przez DataSourceView obiekt. (Odziedziczone po DataSourceView)

Zdarzenia

DataSourceViewChanged	Występuje, gdy widok źródła danych uległ zmianie. (Odziedziczone po DataSourceView)
Deleted	Występuje po zakończeniu operacji usuwania.
Deleting	Występuje przed operacją usuwania.
Filtering	Występuje przed operacją filtrowania.
Inserted	Występuje po zakończeniu operacji wstawiania.
Inserting	Występuje przed operacją wstawiania.
Selected	Występuje po zakończeniu operacji pobierania danych.
Selecting	Występuje przed operacją pobierania danych.
Updated	Występuje po zakończeniu operacji aktualizacji.
Updating	Występuje przed operacją aktualizacji.

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState	Aby uzyskać opis tego członka, zobacz IsTrackingViewState.
IStateManager.LoadViewState(Object)	Aby uzyskać opis tego członka, zobacz LoadViewState(Object).
IStateManager.SaveViewState()	Aby uzyskać opis tego członka, zobacz SaveViewState().
IStateManager.TrackViewState()	Aby uzyskać opis tego członka, zobacz TrackViewState().

Dotyczy