SqlDataSourceView Klasa

Definicja

Obsługuje kontrolkę SqlDataSource i udostępnia interfejs kontrolek powiązanych z danymi w celu wykonywania SQL operacji na danych względem relacyjnych baz 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
SqlDataSourceView
Pochodne
Implementuje

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:

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

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 wykonywania operacji 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 obiekt i udostępniane bezpośrednio przez jego SqlDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

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 mogą być sparametryzowane w celu zwiększenia elastyczności i bezpieczeństwa. Kontrolki powiązane z danymi, takie jak GridView DetailsViewi , można skonfigurować do automatycznego wykonywania operacji usuwania przy użyciu SqlDataSourceViewelementu , 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:

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 odbudowywać zapytanie SQL i ustawiać SelectCommand właściwość przy każdym ładowaniu strony, można użyć FilterExpression właściwości iFilterParameters, aby zastosować filtrowanie dynamiczne do pobierania danych. Te właściwości są implementowane przez kontrolkę SqlDataSourceView i udostępniane bezpośrednio przez kontrolkę SqlDataSource do kontrolek powiązanych z danymi i innych elementów wywołujących.

Dane pobierane za pomocą kontrolki SqlDataSource 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 pobraniu. Wyrażenie sortowania można podać do SqlDataSourceView obiektu , ustawiając SortExpression właściwość DataSourceSelectArguments obiektu, który jest przekazywany do Select metody . Składnia SortExpression właściwości jest taka sama jak składnia DataView.Sort właściwości. 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ść 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. Udostępniono implementacje IsTrackingViewState właściwości i oraz LoadViewStatemetody , SaveViewStatei TrackViewState w celu włączenia śledzenia stanu widoku dla kontrolki. Aby uzyskać więcej informacji, zobacz omówienie zarządzania stanem 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 nullw 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ą parametry, które są używane przez DeleteCommand 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ą parametry, które są używane przez SelectCommand 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ą parametry, które są używane przez UpdateCommand 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 kolekcji oraz wartości, które znajdują się w DeleteParameters określonych keys i oldValues kolekcjach.

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 kolekcji oraz wartości, które znajdują się w DeleteParameters określonych keys i oldValues kolekcjach.

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 SelectCommand bazy danych przy użyciu ciągu SQL i wszystkich parametrów, które znajdują się w kolekcjiSelectParameters.

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 keyskolekcjach , valuesi 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 SelectParameters kolekcji.

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 śledzi zmiany w stanie widoku, tak aby zmiany mogły 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 keyskolekcjach , valuesi 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 elementu członkowskiego, zobacz IsTrackingViewState.

IStateManager.LoadViewState(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz LoadViewState(Object).

IStateManager.SaveViewState()

Aby uzyskać opis tego elementu członkowskiego, zobacz SaveViewState().

IStateManager.TrackViewState()

Aby uzyskać opis tego elementu członkowskiego, zobacz TrackViewState().

Dotyczy

Zobacz też