ObjectDataSourceView 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ę ObjectDataSource i udostępnia interfejs kontrolek powiązanych z danymi w celu wykonywania operacji na danych z obiektami biznesowymi i obiektami danych.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Dziedziczenie: Object

DataSourceView
ObjectDataSourceView

Implementuje: IStateManager

Uwagi

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

Klasa ObjectDataSourceView implementuje funkcje danych dla ObjectDataSource kontrolki, w tym Selectoperacje , Update, Deletei Insert , sortowanie, filtrowanie i zarządzanie ustawieniami przechowywanymi w stanie wyświetlania.

Obiekt ObjectDataSourceView jest tworzony dla każdego wystąpienia ObjectDataSource klasy w czasie wykonywania. Wywołania operacji danych wystąpienia ObjectDataSource klasy są obsługiwane przez wystąpienie ObjectDataSourceView obiektu. Deweloperzy stron nie uzyskują bezpośredniego dostępu do wystąpienia ObjectDataSourceView klasy. Deweloperzy mogą tworzyć niestandardowe kontrolki danych, rozszerzając ObjectDataSource klasy i ObjectDataSourceView .

Klasa ObjectDataSourceView wykonuje operacje danych przez wywoływanie metod na obiektach biznesowych lub danych przy użyciu odbicia. W czasie wykonywania kontrolka ObjectDataSource tworzy wystąpienie typu identyfikowanego przez TypeName właściwość, a następnie wywołuje odpowiednią metodę operacji danych. Wystąpienie obiektu nie jest buforowane w pamięci przez ObjectDataSourceViewobiekt . Obiekt jest tworzony i niszczony dla każdego wywołania metody danych. Jeśli metoda to static (Shared w Visual Basic), wystąpienie nie jest tworzone, ale metoda operacji danych jest nadal wywoływana.

Kontrolka ObjectDataSourceView nie jest bezpośrednio widoczna dla deweloperów ObjectDataSource stron. Zamiast tego są dostępne właściwości i metody za ObjectDataSourceView pośrednictwem elementu ObjectDataSource. Na przykład DeleteMethod właściwość of ObjectDataSourceView jest ustawiana przez ustawienie DeleteMethod właściwości ObjectDataSource.

Pobieranie danych

Najbardziej podstawową operacją wykonywaną przez widok źródła danych jest pobieranie danych z bazowego magazynu danych przy użyciu Select metody , która pobiera IEnumerable kolekcję elementów danych. Następujące metody pobierania danych, właściwości i zdarzenia są implementowane przez ObjectDataSourceView obiekt i udostępniane bezpośrednio przez jego ObjectDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Metoda Select
Właściwość SelectMethod
Właściwość SelectParameters
Zdarzenie Selecting
Zdarzenie Selected

Aktualizowanie danych

Obiekt ObjectDataSourceView obsługuje aktualizacje danych przez wywołanie metody obiektu biznesowego UpdateMethod lub obiektu danych identyfikowanej przez właściwość. Kontrolki powiązane z danymi, które automatycznie wykonują aktualizacje, takie jak GridView kontrolki i DetailsView , przekazują swoje parametry w IOrderedDictionary interfejsie do ObjectDataSourceView obiektu i widoku scalają te parametry z dowolnymi parametrami znalezionymi w UpdateParameters kolekcji.

Następujące metody aktualizacji, właściwości i zdarzenia są implementowane przez ObjectDataSourceView element i udostępniane bezpośrednio przez jego ObjectDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Metoda Update
Właściwość UpdateMethod
Właściwość UpdateParameters
Zdarzenie Updating
Zdarzenie Updated

Wstawianie danych

Obiekt ObjectDataSourceView obsługuje wstawianie nowych wierszy danych przez wywołanie metody obiektu biznesowego InsertMethod lub danych identyfikowanej przez właściwość . Kontrolki powiązane z danymi, które automatycznie wykonują operacje wstawiania, takie jak GridView i DetailsView, przekazują swoje parametry w IOrderedDictionary interfejsie do ObjectDataSourceView obiektu i widoku scalają te parametry z dowolnymi parametrami znalezionymi w InsertParameters kolekcji.

Następujące metody wstawiania, właściwości i zdarzenia są implementowane przez ObjectDataSourceView element i udostępniane bezpośrednio przez jego ObjectDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Metoda Insert
Właściwość InsertMethod
Właściwość InsertParameters
Zdarzenie Inserting
Zdarzenie Inserted

Usuwanie danych

ObjectDataSourceView Obiekt obsługuje usuwanie danych przez wywołanie metody obiektu biznesowego DeleteMethod lub danych identyfikowanej przez właściwość. Kontrolki powiązane z danymi, które automatycznie wykonują operacje usuwania, takie jak GridView i DetailsView, przekazują swoje parametry w IOrderedDictionary interfejsie do ObjectDataSourceView obiektu i widoku scalają te parametry z dowolnymi parametrami znalezionymi w DeleteParameters kolekcji. Następujące metody usuwania, właściwości i zdarzenia są implementowane przez ObjectDataSourceView element i udostępniane bezpośrednio przez jego ObjectDataSource kontrolkę deweloperom stron i innym obiektom wywołującym:

Metoda Delete
Właściwość DeleteMethod
Właściwość DeleteParameters
Zdarzenie Deleting
Zdarzenie Deleted

Filtrowanie i sortowanie danych

Pobieranie danych jest bardziej zaawansowane, gdy można dynamicznie filtrować dane. Filtrowanie jest obsługiwane tylko przez kontrolkę ObjectDataSource , jeśli Select metoda zwraca DataTable obiekt lub DataSet . Właściwości i FilterParameters umożliwiają FilterExpression zastosowanie filtrowania dynamicznego do pobierania danych. Te właściwości są implementowane przez ObjectDataSourceView obiekt i udostępniane bezpośrednio przez jego ObjectDataSource kontrolkę do kontrolek powiązanych z danymi i innych wywołujących.

Dane, które są pobierane ObjectDataSource , można sortować według kolejności danych w pamięci po ich pobraniu. Sortowanie jest obsługiwane tylko przez kontrolkę ObjectDataSource , jeśli Select metoda zwraca wartość DataTable lub DataSet. Właściwość CanSort zawsze zwraca truewartość , ponieważ ObjectDataSourceView nie można określić, jaki typ jest zwracany przez metodę Select bez wywoływania metody. Składnia SortExpression właściwości jest taka sama jak dla DataView.Sort właściwości.

Stan widoku śledzenia

Implementuje ObjectDataSourceView IStateManager interfejs i używa stanu widoku do śledzenia stanu między żądaniami stron. Udostępniono implementację LoadViewStatemetod , SaveViewStatei TrackViewState 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

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicjuje nowe wystąpienie klasy ObjectDataSourceView.

Właściwości

CanDelete	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje operację usuwania.
CanInsert	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje operację wstawiania.
CanPage	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje stronicowanie za pośrednictwem pobranych danych.
CanRetrieveTotalRowCount	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje pobieranie całkowitej liczby wierszy danych oprócz zestawu danych.
CanSort	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje posortowany widok w bazowym źródle danych.
CanUpdate	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt skojarzony z bieżącą ObjectDataSource kontrolką obsługuje operację aktualizacji.
ConflictDetection	Pobiera lub ustawia wartość, która określa, w jaki sposób ObjectDataSource kontrolka wykonuje aktualizacje i usuwa dane z wiersza w bazowym magazynie danych w czasie operacji.
ConvertNullToDBNull	Pobiera lub ustawia wartość wskazującą, czy Parameter wartości przekazywane do operacji aktualizacji, wstawiania lub usuwania są automatycznie konwertowane z `null` wartości.Value
DataObjectTypeName	Pobiera lub ustawia nazwę klasy używanej ObjectDataSource przez kontrolkę dla parametru w operacji danych. Kontrolka ObjectDataSource używa określonej klasy zamiast Parameter obiektów znajdujących się w różnych kolekcjach parametrów.
DeleteMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSourceView przez obiekt w celu usunięcia danych.
DeleteParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez metodę DeleteMethod .
EnablePaging	Pobiera lub ustawia wartość wskazującą, czy kontrolka źródła danych obsługuje stronicowanie za pośrednictwem zestawu pobieranych danych.
Events	Pobiera listę delegatów programu obsługi zdarzeń dla widoku źródła danych. (Odziedziczone po DataSourceView)
FilterExpression	Pobiera lub ustawia wyrażenie filtrowania, które jest stosowane, gdy wywoływana jest metoda obiektu biznesowego SelectMethod identyfikowana przez właściwość.
FilterParameters	Pobiera kolekcję parametrów skojarzonych z dowolnymi symbolami zastępczymi parametrów, które znajdują się w FilterExpression ciągu.
InsertMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSourceView przez obiekt w celu wstawiania danych.
InsertParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez metodę InsertMethod .
IsTrackingViewState	Pobiera wartość wskazującą, czy ObjectDataSourceView obiekt zapisuje zmiany w stanie widoku.
MaximumRowsParameterName	Pobiera lub ustawia nazwę parametru metody pobierania danych, który jest używany do wskazania liczby rekordów do pobrania na potrzeby obsługi stronicowania źródła danych.
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 parametrów dla oryginalnych wartości przekazywanych do `Delete` metod lub `Update` .
ParsingCulture	Pobiera lub ustawia wartość wskazującą, jakie informacje o kulturze są używane podczas konwertowania wartości ciągów na rzeczywiste typy właściwości w celu skonstruowania obiektu typu wskazanego przez DataObjectTypeName.
SelectCountMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSourceView przez kontrolkę w celu pobrania liczby wierszy.
SelectMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSourceView przez kontrolkę w celu pobrania danych.
SelectParameters	Pobiera kolekcję parametrów zawierającą parametry, które są używane przez metodę SelectMethod .
SortParameterName	Pobiera lub ustawia nazwę parametru metody pobierania danych, który służy do określania wyrażenia sortowania dla obsługi sortowania źródła danych.
StartRowIndexParameterName	Pobiera lub ustawia nazwę parametru metody pobierania danych, który jest używany do wskazania indeksu całkowitego pierwszego rekordu do pobrania z zestawu wyników dla obsługi stronicowania źródła danych.
TypeName	Pobiera lub ustawia nazwę klasy, którą reprezentuje kontrolka ObjectDataSource .
UpdateMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSourceView przez obiekt w celu zaktualizowania danych.
UpdateParameters	Pobiera kolekcję parametrów zawierającą parametry, które są używane przez metodę UpdateMethod .

Metody

CanExecute(String)	Określa, czy można wykonać określone polecenie. (Odziedziczone po DataSourceView)
Delete(IDictionary, IDictionary)	Wykonuje operację usuwania, wywołując metodę obiektu biznesowego, która jest identyfikowana przez DeleteMethod właściwość przy użyciu określonej i `keysoldValues` kolekcji.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Wykonuje operację usuwania asynchronicznego na liście danych, które DataSourceView reprezentuje 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 DeleteMethod metody i określonej `keys` i `oldValues` kolekcji.
ExecuteInsert(IDictionary)	Wykonuje operację wstawiania, wywołując metodę obiektu biznesowego, która jest identyfikowana przez InsertMethod właściwość przy użyciu określonej `values` kolekcji.
ExecuteSelect(DataSourceSelectArguments)	Pobiera dane z obiektu, który jest identyfikowany przez TypeName właściwość, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość i przekazując wszelkie wartości w kolekcji SelectParameters .
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod właściwość i używając dowolnych parametrów dostarczonych w `keys`kolekcjach , `values`lub `oldValues` .
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Insert(IDictionary)	Wykonuje operację wstawiania, wywołując metodę obiektu biznesowego, która jest identyfikowana przez InsertMethod właściwość przy użyciu 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 wcześniej 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(ObjectDataSourceStatusEventArgs)	Deleted Zgłasza zdarzenie po zakończeniu ObjectDataSourceView operacji usuwania obiektu.
OnDeleting(ObjectDataSourceMethodEventArgs)	Deleting Zgłasza zdarzenie przed ObjectDataSourceView podjęciem próby usunięcia przez obiekt.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Filtering Zgłasza zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę wykonania operacji filtrowania.
OnInserted(ObjectDataSourceStatusEventArgs)	Inserted Zgłasza zdarzenie po zakończeniu ObjectDataSourceView operacji wstawiania obiektu.
OnInserting(ObjectDataSourceMethodEventArgs)	Inserting Zgłasza zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę operacji wstawiania.
OnObjectCreated(ObjectDataSourceEventArgs)	ObjectCreated Zgłasza zdarzenie po utworzeniu ObjectDataSourceView wystąpienia obiektu identyfikowanego przez TypeName właściwość.
OnObjectCreating(ObjectDataSourceEventArgs)	ObjectCreating Zgłasza zdarzenie przed ObjectDataSourceView utworzeniem wystąpienia obiektu biznesowego w celu wykonania operacji danych.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	ObjectDisposing Zgłasza zdarzenie, zanim ObjectDataSourceView obiekt odrzuci wystąpienie typu.
OnSelected(ObjectDataSourceStatusEventArgs)	Selected Zgłasza zdarzenie po zakończeniu ObjectDataSourceView operacji pobierania danych przez obiekt.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Selecting Zgłasza zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę wykonania operacji pobierania danych.
OnUpdated(ObjectDataSourceStatusEventArgs)	Updated Zgłasza zdarzenie po zakończeniu ObjectDataSourceView operacji aktualizacji obiektu.
OnUpdating(ObjectDataSourceMethodEventArgs)	Updating Zgłasza zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę wykonania operacji aktualizacji.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Wywołana przez metodę RaiseUnsupportedCapabilitiesError(DataSourceView) w celu porównania możliwości żądanych dla ExecuteSelect(DataSourceSelectArguments) operacji względem tych, które obsługuje widok. (Odziedziczone po DataSourceView)
SaveViewState()	Zapisuje zmiany w stanie widoku obiektu ObjectDataSourceView od czasu opublikowania strony z powrotem na serwerze.
Select(DataSourceSelectArguments)	Pobiera dane z obiektu, który jest identyfikowany przez TypeName właściwość, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość i przekazując wszelkie wartości 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()	ObjectDataSourceView Powoduje, że obiekt śledzi zmiany w stanie widoku, tak aby zmiany mogły być przechowywane w ViewState obiekcie dla kontrolki i utrwalane w żądaniach dla tej samej strony.
Update(IDictionary, IDictionary, IDictionary)	Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod właściwość i używając dowolnych parametrów dostarczonych w `keys`kolekcjach , `values`lub `oldValues` .
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Wykonuje operację aktualizacji asynchronicznej 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 Delete operacji.
Deleting	Występuje przed operacją Delete .
Filtering	Występuje przed operacją filtrowania.
Inserted	Występuje po zakończeniu Insert operacji.
Inserting	Występuje przed operacją Insert .
ObjectCreated	Występuje po utworzeniu ObjectDataSourceView wystąpienia typu identyfikowanego przez TypeName właściwość.
ObjectCreating	Występuje przed ObjectDataSourceView utworzeniem wystąpienia typu identyfikowanego przez TypeName właściwość .
ObjectDisposing	Występuje, gdy ObjectDataSourceView obiekt odrzuca wystąpienie utworzonego obiektu.
Selected	Występuje po zakończeniu operacji pobierania danych.
Selecting	Występuje przed operacją pobierania danych.
Updated	Występuje po zakończeniu Update operacji.
Updating	Występuje przed operacją Update .

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