Udostępnij za pośrednictwem


SqlDataSourceView Klasa

Definicja

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

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:

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:

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 formularzy sieci Web. 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 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ą 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, DataSourceViewOperationCallback)

Wykonuje asynchroniczną operację usuwania na liście danych reprezentowanych przez DataSourceView obiekt.

(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 .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Wykonuje określone polecenie.

(Odziedziczone po DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)

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 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, DataSourceViewOperationCallback)

Wykonuje operację asynchronicznego wstawiania na liście danych reprezentowanych przez DataSourceView obiekt.

(Odziedziczone po DataSourceView)
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.

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 DeletedSqlDataSource 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 InsertedSqlDataSource 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 SelectedSqlDataSource 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 UpdatedSqlDataSource 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, DataSourceViewSelectCallback)

Pobiera listę danych asynchronicznie z bazowego magazynu danych.

(Odziedziczone po DataSourceView)
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 .

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, DataSourceViewOperationCallback)

Wykonuje asynchroniczną operację aktualizacji na liście danych reprezentowanych przez DataSourceView obiekt.

(Odziedziczone po DataSourceView)
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 .

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

Zobacz też