ObjectDataSourceView Klasa
Definicja
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
- Implementuje
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 widoku.
Obiekt ObjectDataSourceView jest tworzony dla każdego wystąpienia ObjectDataSource klasy w czasie wykonywania. Wywołania operacji na 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 true
wartość , 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 ObjectDataSourceViewIStateManager 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, jak ObjectDataSource kontrolka wykonuje aktualizacje i usuwa, gdy dane w wierszu w magazynie danych bazowych zmieniają się 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 |
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, które znajdują 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 procedury 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 służy do wskazywania 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 |
ParsingCulture |
Pobiera lub ustawia wartość, która wskazuje, 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 przez ObjectDataSourceView kontrolkę w celu pobrania liczby wierszy. |
SelectMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSourceView 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 na potrzeby obsługi stronicowania źródła danych. |
TypeName |
Pobiera lub ustawia nazwę klasy reprezentowanej przez kontrolkę ObjectDataSource . |
UpdateMethod |
Pobiera lub ustawia nazwę metody lub funkcji wywoływanej przez ObjectDataSourceView 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 przez wywołanie metody obiektu biznesowego DeleteMethod , która jest identyfikowana przez właściwość przy użyciu określonych |
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 DeleteMethod metody i określonej |
ExecuteInsert(IDictionary) |
Wykonuje operację wstawiania, wywołując metodę obiektu biznesowego InsertMethod , która jest identyfikowana przez właściwość przy użyciu określonej |
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 dowolne wartości w SelectParameters kolekcji. |
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 |
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, wywołując metodę obiektu biznesowego InsertMethod , która jest identyfikowana przez właściwość przy użyciu określonej |
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 Wywołuje zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę usunięcia operacji. |
OnFiltering(ObjectDataSourceFilteringEventArgs) |
Filtering Wywołuje zdarzenie, zanim ObjectDataSourceView obiekt podejmie próbę wykonania operacji filtrowania. |
OnInserted(ObjectDataSourceStatusEventArgs) |
Zgłasza zdarzenie po zakończeniu InsertedObjectDataSourceView operacji wstawiania obiektu. |
OnInserting(ObjectDataSourceMethodEventArgs) |
Inserting Wywołuje zdarzenie przed podjęciem ObjectDataSourceView próby wykonania operacji wstawiania. |
OnObjectCreated(ObjectDataSourceEventArgs) |
ObjectCreated Wywołuje zdarzenie po utworzeniu ObjectDataSourceView wystąpienia obiektu identyfikowanego TypeName przez właściwość . |
OnObjectCreating(ObjectDataSourceEventArgs) |
ObjectCreating Wywołuje zdarzenie przed ObjectDataSourceView utworzeniem wystąpienia obiektu biznesowego w celu wykonania operacji na danych. |
OnObjectDisposing(ObjectDataSourceDisposingEventArgs) |
ObjectDisposing Wywołuje zdarzenie, zanim ObjectDataSourceView obiekt odrzuci wystąpienie typu. |
OnSelected(ObjectDataSourceStatusEventArgs) |
Zgłasza zdarzenie po zakończeniu SelectedObjectDataSourceView operacji pobierania danych przez obiekt. |
OnSelecting(ObjectDataSourceSelectingEventArgs) |
Selecting Wywołuje 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 stanu 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 dowolne wartości 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() |
ObjectDataSourceView Powoduje, że obiekt będzie śledzić zmiany stanu widoku, dzięki czemu zmiany mogą 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 |
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 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, które jest identyfikowane przez TypeName właściwość . |
ObjectCreating |
Występuje przed utworzeniem ObjectDataSourceView wystąpienia typu, które jest identyfikowane 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 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(). |