ObjectDataSourceView Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Ondersteunt het ObjectDataSource besturingselement en biedt een interface voor gegevensgebonden besturingselementen voor het uitvoeren van gegevensbewerkingen met zakelijke en gegevensobjecten.

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

Overname: Object

DataSourceView
ObjectDataSourceView

Implementeringen: IStateManager

Opmerkingen

De ObjectDataSourceView klasse is voornamelijk bedoeld om te worden gebruikt door gegevensgebonden besturingselementen en niet als programmeerbaar object in paginacode.

De ObjectDataSourceView klasse implementeert de gegevensfunctionaliteit voor het ObjectDataSource besturingselement, waaronder de Selectbewerkingen , Updateen Delete Insert bewerkingen, sorteren, filteren en beheren van instellingen die in de weergavestatus worden bewaard.

Er wordt tijdens runtime een ObjectDataSourceView object gemaakt voor elk exemplaar van de ObjectDataSource klasse. Aanroepen naar gegevensbewerkingen van het exemplaar van de ObjectDataSource klasse worden verwerkt door het exemplaar van het ObjectDataSourceView object. Paginaontwikkelaars hebben geen rechtstreeks toegang tot het exemplaar van de ObjectDataSourceView klasse. Ontwikkelaars kunnen aangepaste gegevensbesturingselementen maken door de ObjectDataSource en ObjectDataSourceView klassen uit te breiden.

De ObjectDataSourceView klasse voert gegevensbewerkingen uit door methoden aan te roepen voor zakelijke of gegevensobjecten met behulp van weerspiegeling. Tijdens runtime maakt het ObjectDataSource besturingselement een exemplaar van het type dat wordt geïdentificeerd door de TypeName eigenschap en roept het vervolgens de juiste methode aan voor de gegevensbewerking. Het geïnstantieerde object wordt niet in de cache opgeslagen in het geheugen door de ObjectDataSourceView. Het object wordt gemaakt en vernietigd voor elke aanroep van de gegevensmethode. Als de methode is static (Shared in Visual Basic), wordt er geen exemplaar gemaakt, maar wordt de methode voor gegevensbewerking nog steeds aangeroepen.

Het ObjectDataSourceView is niet rechtstreeks beschikbaar voor paginaontwikkelaars door het ObjectDataSource besturingselement. In plaats daarvan worden de eigenschappen en methoden van de opties ObjectDataSourceView geopend via de ObjectDataSource. De eigenschap wordt bijvoorbeeld DeleteMethod ObjectDataSourceView ingesteld door de DeleteMethod eigenschap van de ObjectDataSourceeigenschap in te stellen.

Gegevens ophalen

De meest eenvoudige bewerking die een gegevensbronweergave uitvoert, is het ophalen van gegevens uit de onderliggende gegevensopslag met behulp van de Select methode, waarmee een IEnumerable verzameling gegevensitems wordt opgehaald. De volgende methoden, eigenschappen en gebeurtenissen voor het ophalen van gegevens worden door het ObjectDataSourceView object geïmplementeerd en rechtstreeks beschikbaar gesteld door het ObjectDataSource besturingselement voor paginaontwikkelaars en andere bellers:

De methode Select
De SelectMethod eigenschap
De SelectParameters eigenschap
De Selecting gebeurtenis
De Selected gebeurtenis

Gegevens bijwerken

Het ObjectDataSourceView object ondersteunt gegevensupdates door een zakelijke of gegevensobjectmethode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap. Gegevensgebonden besturingselementen die automatisch updates uitvoeren, zoals de GridView en DetailsView besturingselementen, geven hun parameters door in een IOrderedDictionary interface aan het ObjectDataSourceView en het weergaveobject voegt deze parameters samen met alle parameters die in de UpdateParameters verzameling worden gevonden.

De volgende updatemethoden, eigenschappen en gebeurtenissen worden geïmplementeerd door en ObjectDataSourceView rechtstreeks beschikbaar gesteld door het ObjectDataSource besturingselement voor paginaontwikkelaars en andere bellers:

De methode Update
De UpdateMethod eigenschap
De UpdateParameters eigenschap
De Updating gebeurtenis
De Updated gebeurtenis

Gegevens invoegen

Het ObjectDataSourceView object ondersteunt het invoegen van nieuwe rijen met gegevens door een zakelijke of gegevensobjectmethode aan te roepen die wordt geïdentificeerd door de InsertMethod eigenschap. Met gegevens gebonden besturingselementen waarmee automatisch invoegingen worden uitgevoerd, zoals de GridView en DetailsView, worden de parameters in een IOrderedDictionary interface doorgegeven aan de ObjectDataSourceView en worden deze parameters samengevoegd met alle parameters die in de InsertParameters verzameling worden gevonden.

De volgende methoden, eigenschappen en gebeurtenissen worden geïmplementeerd door de ObjectDataSourceView en rechtstreeks beschikbaar gesteld door het ObjectDataSource besturingselement voor paginaontwikkelaars en andere bellers:

De methode Insert
De InsertMethod eigenschap
De InsertParameters eigenschap
De Inserting gebeurtenis
De Inserted gebeurtenis

Gegevens verwijderen

Het ObjectDataSourceView object ondersteunt het verwijderen van gegevens door een zakelijke of gegevensobjectmethode aan te roepen die wordt geïdentificeerd door de DeleteMethod eigenschap. Gegevensgebonden besturingselementen die automatisch verwijderingen uitvoeren, zoals de GridView en DetailsView, geven hun parameters door in een IOrderedDictionary interface aan het ObjectDataSourceView en het weergaveobject voegt deze parameters samen met alle parameters die in de DeleteParameters verzameling zijn gevonden. De volgende verwijdermethoden, eigenschappen en gebeurtenissen worden geïmplementeerd door de ObjectDataSourceView en rechtstreeks beschikbaar worden gesteld door ObjectDataSource de controle voor paginaontwikkelaars en andere bellers:

De methode Delete
De DeleteMethod eigenschap
De DeleteParameters eigenschap
De Deleting gebeurtenis
De Deleted gebeurtenis

Gegevens filteren en sorteren

Het ophalen van gegevens is krachtiger wanneer u de gegevens dynamisch kunt filteren. Filteren wordt alleen ondersteund door het ObjectDataSource besturingselement als de Select methode een DataTable of DataSet object retourneert. U kunt de FilterExpression en FilterParameters eigenschappen gebruiken om dynamisch filteren toe te passen op het ophalen van gegevens. Deze eigenschappen worden door het ObjectDataSourceView object geïmplementeerd en rechtstreeks door het ObjectDataSource besturingselement zichtbaar gemaakt voor gegevensgebonden besturingselementen en andere bellers.

U kunt de gegevens die u met de ObjectDataSource gegevens ophaalt sorteren door de gegevens in het geheugen te ordenen nadat deze zijn opgehaald. Sorteren wordt alleen ondersteund door het ObjectDataSource besturingselement als de Select methode een DataTable of DataSet. De CanSort eigenschap retourneert truealtijd, omdat de ObjectDataSourceView eigenschap niet kan bepalen welk type door de Select methode wordt geretourneerd zonder de methode aan te roepen. De SortExpression syntaxis van de eigenschap is hetzelfde als voor een DataView.Sort eigenschap.

Status van traceringsweergave

De ObjectDataSourceView interface wordt geïmplementeerd IStateManager en de weergavestatus wordt gebruikt om de status bij te houden op paginaaanvragen. Implementatie van de LoadViewState, SaveViewStateen TrackViewState methoden worden geboden om het bijhouden van statussen voor het besturingselement in te schakelen. Zie ASP.NET State Management Overview voor meer informatie.

Constructors

Name	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Initialiseert een nieuw exemplaar van de ObjectDataSourceView klasse.

Eigenschappen

Name	Description
CanDelete	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat is gekoppeld aan het huidige ObjectDataSource besturingselement de verwijderbewerking ondersteunt.
CanInsert	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat is gekoppeld aan het huidige ObjectDataSource besturingselement de invoegbewerking ondersteunt.
CanPage	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat is gekoppeld aan het huidige ObjectDataSource besturingselement ondersteuning biedt voor paging via de opgehaalde gegevens.
CanRetrieveTotalRowCount	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat aan het huidige ObjectDataSource besturingselement is gekoppeld, het totale aantal gegevensrijen kan ophalen, naast de set gegevens.
CanSort	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat is gekoppeld aan het huidige ObjectDataSource besturingselement een gesorteerde weergave op de onderliggende gegevensbron ondersteunt.
CanUpdate	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object dat is gekoppeld aan het huidige ObjectDataSource besturingselement de updatebewerking ondersteunt.
ConflictDetection	Hiermee wordt een waarde opgehaald of ingesteld die bepaalt hoe het ObjectDataSource besturingselement updates uitvoert en verwijdert wanneer gegevens in een rij in de onderliggende gegevensopslag veranderen tijdens de tijd van de bewerking.
ConvertNullToDBNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of Parameter waarden die worden doorgegeven aan een update-, invoeg- of verwijderbewerking automatisch worden geconverteerd van `null` naar de Value waarde.
DataObjectTypeName	Hiermee haalt u de naam op van een klasse die door het ObjectDataSource besturingselement wordt gebruikt voor een parameter in een gegevensbewerking. Het ObjectDataSource besturingselement gebruikt de opgegeven klasse in plaats van de Parameter objecten in de verschillende parametersverzamelingen.
DeleteMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView object wordt aangeroepen om gegevens te verwijderen.
DeleteParameters	Hiermee haalt u de verzameling parameters op die de parameters bevat die door de DeleteMethod methode worden gebruikt.
EnablePaging	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement voor gegevensbron paging ondersteunt via de set gegevens die worden opgehaald.
Events	Hiermee haalt u een lijst met gedelegeerden voor de gebeurtenis-handler op voor de gegevensbronweergave. (Overgenomen van DataSourceView)
FilterExpression	Hiermee wordt een filterexpressie opgehaald of ingesteld die wordt toegepast wanneer de bedrijfsobjectmethode die wordt geïdentificeerd door de SelectMethod eigenschap wordt aangeroepen.
FilterParameters	Hiermee haalt u een verzameling parameters op die zijn gekoppeld aan tijdelijke aanduidingen voor parameters die zich in de FilterExpression tekenreeks bevinden.
InsertMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView object wordt aangeroepen om gegevens in te voegen.
InsertParameters	Hiermee haalt u de verzameling parameters op die de parameters bevat die door de InsertMethod methode worden gebruikt.
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het ObjectDataSourceView object wijzigingen opslaat in de weergavestatus.
MaximumRowsParameterName	Hiermee haalt u de naam op van de parameter voor de methode voor het ophalen van gegevens die wordt gebruikt om het aantal records aan te geven dat moet worden opgehaald voor ondersteuning voor paging van gegevensbronnen.
Name	Hiermee haalt u de naam van de gegevensbronweergave op. (Overgenomen van DataSourceView)
OldValuesParameterFormatString	Hiermee haalt u een notatietekenreeks op die moet worden toegepast op de namen van de parameters voor oorspronkelijke waarden die worden doorgegeven aan de `Delete` of `Update` methoden.
ParsingCulture	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft welke cultuurgegevens worden gebruikt bij het converteren van tekenreekswaarden naar werkelijke eigenschapstypen om een object van het type te maken dat wordt aangegeven door DataObjectTypeName.
SelectCountMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView besturingselement wordt aangeroepen om het aantal rijen op te halen.
SelectMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView besturingselement wordt aangeroepen om gegevens op te halen.
SelectParameters	Hiermee haalt u de verzameling parameters op die de parameters bevatten die door de SelectMethod methode worden gebruikt.
SortParameterName	Hiermee haalt u de naam op van de methodeparameter voor het ophalen van gegevens die wordt gebruikt om een sorteerexpressie op te geven voor de ondersteuning voor het sorteren van gegevensbronnen.
StartRowIndexParameterName	Hiermee haalt u de naam op van de methodeparameter voor het ophalen van gegevens die wordt gebruikt om de gehele index van de eerste record aan te geven die moet worden opgehaald uit de resultatenset voor pagine-ondersteuning voor gegevensbronnen.
TypeName	Hiermee haalt u de naam op van de klasse die het ObjectDataSource besturingselement vertegenwoordigt.
UpdateMethod	Hiermee haalt u de naam op van de methode of functie die door het ObjectDataSourceView object wordt aangeroepen om gegevens bij te werken.
UpdateParameters	Hiermee haalt u de verzameling parameters op die de parameters bevatten die door de UpdateMethod methode worden gebruikt.

Methoden

Name	Description
CanExecute(String)	Bepaalt of de opgegeven opdracht kan worden uitgevoerd. (Overgenomen van DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Voert een asynchrone verwijderbewerking uit in de lijst met gegevens die het DataSourceView object vertegenwoordigt. (Overgenomen van DataSourceView)
Delete(IDictionary, IDictionary)	Voert een verwijderbewerking uit door de bedrijfsobjectmethode aan te roepen die wordt geïdentificeerd door de DeleteMethod eigenschap met behulp van de opgegeven `keys` verzamelingen.`oldValues`
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Hiermee wordt de opgegeven opdracht uitgevoerd. (Overgenomen van DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Hiermee wordt de opgegeven opdracht uitgevoerd. (Overgenomen van DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Voert een verwijderbewerking uit met behulp van de DeleteMethod methode en de opgegeven `keys` en `oldValues` verzameling.
ExecuteInsert(IDictionary)	Voert een invoegbewerking uit door de bedrijfsobjectmethode aan te roepen die wordt geïdentificeerd door de InsertMethod eigenschap met behulp van de opgegeven `values` verzameling.
ExecuteSelect(DataSourceSelectArguments)	Hiermee worden gegevens opgehaald uit het object dat wordt geïdentificeerd door de TypeName eigenschap door de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap en eventuele waarden in de SelectParameters verzameling door te geven.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Voert een updatebewerking uit door de methode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap en met behulp van parameters die zijn opgegeven in de `keys`, `values`of `oldValues` verzamelingen.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Voert een asynchrone invoegbewerking uit in de lijst met gegevens die het DataSourceView object vertegenwoordigt. (Overgenomen van DataSourceView)
Insert(IDictionary)	Voert een invoegbewerking uit door de bedrijfsobjectmethode aan te roepen die wordt geïdentificeerd door de InsertMethod eigenschap met behulp van de opgegeven `values` verzameling.
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus voor de gegevensbronweergave.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnDataSourceViewChanged(EventArgs)	Hiermee wordt de DataSourceViewChanged gebeurtenis gegenereerd. (Overgenomen van DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Hiermee wordt de Deleted gebeurtenis gegenereerd nadat het object een ObjectDataSourceView verwijderbewerking heeft voltooid.
OnDeleting(ObjectDataSourceMethodEventArgs)	Hiermee wordt de Deleting gebeurtenis gegenereerd voordat het ObjectDataSourceView object een verwijderbewerking probeert uit te voeren.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Hiermee wordt de Filtering gebeurtenis gegenereerd voordat het ObjectDataSourceView object een filterbewerking probeert uit te voeren.
OnInserted(ObjectDataSourceStatusEventArgs)	Hiermee wordt de Inserted gebeurtenis gegenereerd nadat het ObjectDataSourceView object een invoegbewerking heeft voltooid.
OnInserting(ObjectDataSourceMethodEventArgs)	Hiermee wordt de Inserting gebeurtenis gegenereerd voordat het ObjectDataSourceView object een invoegbewerking probeert uit te voeren.
OnObjectCreated(ObjectDataSourceEventArgs)	Hiermee wordt de ObjectCreated gebeurtenis gegenereerd nadat er ObjectDataSourceView een exemplaar is gemaakt van het object dat wordt geïdentificeerd door de TypeName eigenschap.
OnObjectCreating(ObjectDataSourceEventArgs)	Hiermee wordt de ObjectCreating gebeurtenis gegenereerd voordat het ObjectDataSourceView object een exemplaar van een zakelijk object maakt om een gegevensbewerking uit te voeren.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Hiermee wordt de ObjectDisposing gebeurtenis gegenereerd voordat het ObjectDataSourceView object een geïnstantieerd type negeert.
OnSelected(ObjectDataSourceStatusEventArgs)	Hiermee wordt de Selected gebeurtenis gegenereerd nadat het ObjectDataSourceView object een bewerking voor het ophalen van gegevens heeft voltooid.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Hiermee wordt de Selecting gebeurtenis gegenereerd voordat het ObjectDataSourceView object een bewerking voor het ophalen van gegevens probeert uit te voeren.
OnUpdated(ObjectDataSourceStatusEventArgs)	Hiermee wordt de Updated gebeurtenis gegenereerd nadat het ObjectDataSourceView object een updatebewerking heeft voltooid.
OnUpdating(ObjectDataSourceMethodEventArgs)	Hiermee wordt de Updating gebeurtenis gegenereerd voordat het ObjectDataSourceView object een updatebewerking probeert uit te voeren.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Aangeroepen door de RaiseUnsupportedCapabilitiesError(DataSourceView) methode om de mogelijkheden te vergelijken die zijn aangevraagd voor een ExecuteSelect(DataSourceSelectArguments) bewerking ten opzichte van de mogelijkheden die door de weergave worden ondersteund. (Overgenomen van DataSourceView)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het ObjectDataSourceView object sinds het tijdstip waarop de pagina op de server is geplaatst.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Hiermee wordt een lijst met gegevens asynchroon opgehaald uit de onderliggende gegevensopslag. (Overgenomen van DataSourceView)
Select(DataSourceSelectArguments)	Hiermee worden gegevens opgehaald uit het object dat wordt geïdentificeerd door de TypeName eigenschap door de methode aan te roepen die wordt geïdentificeerd door de SelectMethod eigenschap en eventuele waarden in de SelectParameters verzameling door te geven.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee zorgt u ervoor dat het ObjectDataSourceView object wijzigingen in de weergavestatus bijhoudt, zodat de wijzigingen kunnen worden opgeslagen in het ViewState object voor het besturingselement en blijven bestaan tussen aanvragen voor dezelfde pagina.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Voert een asynchrone updatebewerking uit in de lijst met gegevens die het DataSourceView object vertegenwoordigt. (Overgenomen van DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Voert een updatebewerking uit door de methode aan te roepen die wordt geïdentificeerd door de UpdateMethod eigenschap en met behulp van parameters die zijn opgegeven in de `keys`, `values`of `oldValues` verzamelingen.

gebeurtenis

Name	Description
DataSourceViewChanged	Treedt op wanneer de gegevensbronweergave is gewijzigd. (Overgenomen van DataSourceView)
Deleted	Vindt plaats wanneer een Delete bewerking is voltooid.
Deleting	Vindt plaats vóór een Delete bewerking.
Filtering	Vindt plaats vóór een filterbewerking.
Inserted	Treedt op wanneer een Insert bewerking is voltooid.
Inserting	Vindt plaats vóór een Insert bewerking.
ObjectCreated	Vindt plaats nadat het ObjectDataSourceView object een exemplaar van het type heeft gemaakt dat wordt geïdentificeerd door de TypeName eigenschap.
ObjectCreating	Vindt plaats voordat het ObjectDataSourceView object een exemplaar maakt van het type dat wordt geïdentificeerd door de TypeName eigenschap.
ObjectDisposing	Treedt op wanneer het ObjectDataSourceView object een exemplaar verwijdert van een object dat het heeft gemaakt.
Selected	Treedt op wanneer een bewerking voor het ophalen van gegevens is voltooid.
Selecting	Vindt plaats vóór een bewerking voor het ophalen van gegevens.
Updated	Treedt op wanneer een Update bewerking is voltooid.
Updating	Vindt plaats vóór een Update bewerking.

Expliciete interface-implementaties

Name	Description
IStateManager.IsTrackingViewState	Zie voor een beschrijving van dit lid IsTrackingViewState.
IStateManager.LoadViewState(Object)	Zie voor een beschrijving van dit lid LoadViewState(Object).
IStateManager.SaveViewState()	Zie voor een beschrijving van dit lid SaveViewState().
IStateManager.TrackViewState()	Zie voor een beschrijving van dit lid TrackViewState().

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?