ObjectDataSourceView Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Stöder kontrollen ObjectDataSource och tillhandahåller ett gränssnitt för databundna kontroller för att utföra dataåtgärder med affärs- och dataobjekt.

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
Arv
Object
DataSourceView
ObjectDataSourceView
Implementeringar
IStateManager

Kommentarer

Klassen ObjectDataSourceView är främst avsedd att användas av databundna kontroller och inte som ett programmerbart objekt i sidkoden.

Klassen ObjectDataSourceView implementerar datafunktionerna ObjectDataSource för kontrollen, inklusive Selectåtgärderna , Update, Deleteoch Insert , sortering, filtrering och hantering av inställningar som hålls i visningstillstånd.

Ett ObjectDataSourceView objekt skapas för varje instans av ObjectDataSource klassen vid körning. Anrop till dataåtgärder för instansen ObjectDataSource av klassen hanteras av objektets ObjectDataSourceView instans. Sidutvecklare kommer inte åt instansen ObjectDataSourceView av klassen direkt. Kontrollutvecklare kan skapa anpassade datakontroller genom att utöka klasserna ObjectDataSource och ObjectDataSourceView .

Klassen ObjectDataSourceView utför dataåtgärder genom att anropa metoder för affärs- eller dataobjekt med reflektion. Vid körning skapar ObjectDataSource kontrollen en instans av den typ som identifieras av TypeName egenskapen och anropar sedan lämplig metod för dataåtgärden. Det instansierade objektet cachelagras inte i minnet av ObjectDataSourceView. Objektet skapas och förstörs för varje datametodanrop. Om metoden är static (Shared i Visual Basic) skapas ingen instans men dataåtgärdsmetoden anropas fortfarande.

ObjectDataSourceView Är inte direkt exponerad för sidutvecklare av ObjectDataSource kontrollen. I stället används ObjectDataSourceViewegenskaperna och metoderna för ObjectDataSource . Till exempel DeleteMethod anges egenskapen för ObjectDataSourceView genom att DeleteMethod ange egenskapen för ObjectDataSource.

Hämtar data

Den mest grundläggande åtgärden som en datakällasvy utför är datahämtning från den underliggande datalagringen Select med hjälp av metoden som hämtar en IEnumerable samling dataobjekt. Följande datahämtningsmetoder, egenskaper och händelser implementeras av ObjectDataSourceView objektet och exponeras direkt av dess ObjectDataSource kontroll för sidutvecklare och andra anropare:

Uppdatera data

Objektet ObjectDataSourceView stöder datauppdateringar genom att anropa en affärs- eller dataobjektmetod som identifieras av egenskapen UpdateMethod . Databundna kontroller som automatiskt utför uppdateringar, till exempel GridView kontrollerna och DetailsView , skickar sina parametrar i ett IOrderedDictionary gränssnitt till ObjectDataSourceView och visningsobjektet sammanfogar dessa parametrar med alla parametrar som finns i UpdateParameters samlingen.

Följande uppdateringsmetoder, egenskaper och händelser implementeras av ObjectDataSourceView och exponeras direkt av dess ObjectDataSource kontroll för sidutvecklare och andra anropare:

Infoga data

Objektet ObjectDataSourceView stöder infogning av nya datarader genom att anropa en affärs- eller dataobjektmetod som identifieras av egenskapen InsertMethod . Databundna kontroller som automatiskt utför infogningar, till exempel GridView och DetailsView, skickar sina parametrar i ett IOrderedDictionary gränssnitt till ObjectDataSourceView och visningsobjektet sammanfogar dessa parametrar med alla parametrar som finns i InsertParameters samlingen.

Följande infogningsmetoder, egenskaper och händelser implementeras av ObjectDataSourceView och exponeras direkt av dess ObjectDataSource kontroll för sidutvecklare och andra anropare:

Ta bort data

Objektet ObjectDataSourceView stöder borttagning av data genom att anropa en affärs- eller dataobjektmetod som identifieras av DeleteMethod egenskapen. Databundna kontroller som automatiskt utför borttagningar, till exempel GridView och DetailsView, skickar sina parametrar i ett IOrderedDictionary gränssnitt till ObjectDataSourceView och visningsobjektet sammanfogar dessa parametrar med alla parametrar som finns i DeleteParameters samlingen. Följande borttagningsmetoder, egenskaper och händelser implementeras av ObjectDataSourceView och exponeras direkt av dess ObjectDataSource kontroll för sidutvecklare och andra anropare:

Filtrera och sortera data

Datahämtning är mer kraftfullt när du kan filtrera data dynamiskt. Filtrering stöds endast av ObjectDataSource kontrollen om Select metoden returnerar ett DataTable eller DataSet -objekt. Du kan använda FilterExpression egenskaperna och FilterParameters för att tillämpa dynamisk filtrering på datahämtning. Dessa egenskaper implementeras av ObjectDataSourceView objektet och exponeras direkt av dess ObjectDataSource kontroll för databundna kontroller och andra anropare.

Du kan sortera de data som du hämtar med ObjectDataSource genom att sortera data i minnet när de har hämtats. Sortering stöds endast av ObjectDataSource kontrollen om Select metoden returnerar en DataTable eller DataSet. Egenskapen CanSort returnerar truealltid , eftersom ObjectDataSourceView det inte går att avgöra vilken typ som returneras av Select metoden utan att anropa metoden. Egenskapssyntaxen SortExpression är densamma som för en DataView.Sort egenskap.

Spårningsvytillstånd

Implementerar ObjectDataSourceView gränssnittet och använder visningstillstånd IStateManager för att spåra dess tillstånd över sidbegäranden. Implementering av metoderna , LoadViewStateoch SaveViewState tillhandahålls för att aktivera spårning av TrackViewStatevisningstillstånd för kontrollen. Mer information finns i ASP.NET State Management Overview.

Konstruktorer

Name Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Initierar en ny instans av ObjectDataSourceView klassen.

Egenskaper

Name Description
CanDelete

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder borttagningsåtgärden.
CanInsert

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder infogningsåtgärden.
CanPage

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder växling via hämtade data.
CanRetrieveTotalRowCount

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder hämtning av det totala antalet datarader, utöver datauppsättningen.
CanSort

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder en sorterad vy på den underliggande datakällan.
CanUpdate

Hämtar ett värde som anger om objektet ObjectDataSourceView som är associerat med den aktuella ObjectDataSource kontrollen stöder uppdateringsåtgärden.
ConflictDetection

Hämtar eller anger ett värde som avgör hur ObjectDataSource kontrollen utför uppdateringar och tar bort när data i en rad i den underliggande datalagringen ändras under tiden för åtgärden.
ConvertNullToDBNull

Hämtar eller anger ett värde som anger om Parameter värden som skickas till en uppdaterings-, infognings- eller borttagningsåtgärd automatiskt konverteras från null till värdet Value .
DataObjectTypeName

Hämtar eller anger namnet på en klass som ObjectDataSource kontrollen använder för en parameter i en dataåtgärd. Kontrollen ObjectDataSource använder den angivna klassen i stället för de Parameter objekt som finns i de olika parametersamlingarna.
DeleteMethod

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView objektet anropar för att ta bort data.
DeleteParameters

Hämtar den parametersamling som innehåller de parametrar som används av DeleteMethod metoden.
EnablePaging

Hämtar eller anger ett värde som anger om datakällans kontroll stöder växling via den uppsättning data som den hämtar.
Events

Hämtar en lista över händelsehanterardelegater för datakällans vy.

(Ärvd från DataSourceView)
FilterExpression

Hämtar eller anger ett filtreringsuttryck som tillämpas när affärsobjektmetoden som identifieras av SelectMethod egenskapen anropas.
FilterParameters

Hämtar en samling parametrar som är associerade med alla parameterplatshållare som finns i strängen FilterExpression .
InsertMethod

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView objektet anropar för att infoga data.
InsertParameters

Hämtar den parametersamling som innehåller de parametrar som används av InsertMethod metoden.
IsTrackingViewState

Hämtar ett värde som anger om ObjectDataSourceView objektet sparar ändringar i visningstillståndet.
MaximumRowsParameterName

Hämtar eller anger namnet på datahämtningsmetodparametern som används för att ange antalet poster som ska hämtas för stöd för datakällans växling.
Name

Hämtar namnet på datakällans vy.

(Ärvd från DataSourceView)
OldValuesParameterFormatString

Hämtar eller anger en formatsträng som ska tillämpas på namnen på parametrarna för ursprungliga värden som skickas till Delete metoderna eller Update .
ParsingCulture

Hämtar ett eller anger ett värde som anger vilken kulturinformation som används vid konvertering av strängvärden till faktiska egenskapstyper för att konstruera ett objekt av den typ som anges av DataObjectTypeName.
SelectCountMethod

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView kontrollen anropar för att hämta ett radantal.
SelectMethod

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView kontrollen anropar för att hämta data.
SelectParameters

Hämtar parametersamlingen som innehåller de parametrar som används av SelectMethod metoden.
SortParameterName

Hämtar eller anger namnet på den datahämtningsmetodparameter som används för att ange ett sorteringsuttryck för stöd för datakällans sortering.
StartRowIndexParameterName

Hämtar eller anger namnet på den datahämtningsmetodparameter som används för att ange heltalsindexet för den första posten som ska hämtas från resultatuppsättningen för stöd för datakällans växling.
TypeName

Hämtar eller anger namnet på klassen som ObjectDataSource kontrollen representerar.
UpdateMethod

Hämtar eller anger namnet på den metod eller funktion som ObjectDataSourceView objektet anropar för att uppdatera data.
UpdateParameters

Hämtar parametersamlingen som innehåller de parametrar som används av UpdateMethod metoden.

Metoder

Name Description
CanExecute(String)

Avgör om det angivna kommandot kan köras.

(Ärvd från DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Utför en asynkron borttagningsåtgärd i listan över data som DataSourceView objektet representerar.

(Ärvd från DataSourceView)
Delete(IDictionary, IDictionary)

Utför en borttagningsåtgärd genom att anropa affärsobjektmetoden som identifieras av egenskapen med hjälp av DeleteMethod angivna keys samlingar och oldValues samlingar.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Kör det angivna kommandot.

(Ärvd från DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)

Kör det angivna kommandot.

(Ärvd från DataSourceView)
ExecuteDelete(IDictionary, IDictionary)

Utför en borttagningsåtgärd med hjälp av DeleteMethod metoden och den angivna keys och oldValues samlingen.
ExecuteInsert(IDictionary)

Utför en infogningsåtgärd genom att anropa den affärsobjektmetod som identifieras av egenskapen med hjälp av InsertMethod den angivna values samlingen.
ExecuteSelect(DataSourceSelectArguments)

Hämtar data från objektet som identifieras av TypeName egenskapen genom att anropa metoden som identifieras av SelectMethod egenskapen och skicka eventuella värden i SelectParameters samlingen.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Utför en uppdateringsåtgärd genom att anropa den metod som identifieras av UpdateMethod egenskapen och använda parametrar som anges i keys, valueseller oldValues samlingarna.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Insert(IDictionary, DataSourceViewOperationCallback)

Utför en asynkron infogningsåtgärd i listan över data som DataSourceView objektet representerar.

(Ärvd från DataSourceView)
Insert(IDictionary)

Utför en infogningsåtgärd genom att anropa den affärsobjektmetod som identifieras av egenskapen med hjälp av InsertMethod den angivna values samlingen.
LoadViewState(Object)

Återställer tidigare sparat visningstillstånd för datakällans vy.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnDataSourceViewChanged(EventArgs)

Genererar händelsen DataSourceViewChanged .

(Ärvd från DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)

Genererar Deleted händelsen när objektet ObjectDataSourceView har slutfört en borttagningsåtgärd.
OnDeleting(ObjectDataSourceMethodEventArgs)

Genererar händelsen Deleting innan objektet ObjectDataSourceView försöker ta bort en åtgärd.
OnFiltering(ObjectDataSourceFilteringEventArgs)

Genererar händelsen Filtering innan objektet ObjectDataSourceView försöker utföra en filtreringsåtgärd.
OnInserted(ObjectDataSourceStatusEventArgs)

Genererar Inserted händelsen när objektet ObjectDataSourceView har slutfört en infogningsåtgärd.
OnInserting(ObjectDataSourceMethodEventArgs)

Genererar händelsen Inserting innan objektet ObjectDataSourceView försöker utföra en infogningsåtgärd.
OnObjectCreated(ObjectDataSourceEventArgs)

Genererar ObjectCreated händelsen efter att ObjectDataSourceView en instans av objektet som identifieras av TypeName egenskapen har skapats.
OnObjectCreating(ObjectDataSourceEventArgs)

Genererar ObjectCreating händelsen innan objektet ObjectDataSourceView skapar en instans av ett affärsobjekt för att utföra en dataåtgärd.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Genererar ObjectDisposing händelsen innan objektet ObjectDataSourceView tar bort en instansierad typ.
OnSelected(ObjectDataSourceStatusEventArgs)

Genererar Selected händelsen när objektet ObjectDataSourceView har slutfört en datahämtningsåtgärd.
OnSelecting(ObjectDataSourceSelectingEventArgs)

Genererar händelsen Selecting innan objektet ObjectDataSourceView försöker hämta data.
OnUpdated(ObjectDataSourceStatusEventArgs)

Genererar Updated händelsen när objektet ObjectDataSourceView har slutfört en uppdateringsåtgärd.
OnUpdating(ObjectDataSourceMethodEventArgs)

Genererar händelsen Updating innan objektet ObjectDataSourceView försöker utföra en uppdateringsåtgärd.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Anropas av RaiseUnsupportedCapabilitiesError(DataSourceView) metoden för att jämföra de funktioner som begärs för en ExecuteSelect(DataSourceSelectArguments) åtgärd med de som vyn stöder.

(Ärvd från DataSourceView)
SaveViewState()

Sparar ändringarna i visningstillståndet ObjectDataSourceView för objektet sedan den tid då sidan publicerades tillbaka till servern.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Hämtar en lista över data asynkront från den underliggande datalagringen.

(Ärvd från DataSourceView)
Select(DataSourceSelectArguments)

Hämtar data från objektet som identifieras av TypeName egenskapen genom att anropa metoden som identifieras av SelectMethod egenskapen och skicka eventuella värden i SelectParameters samlingen.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TrackViewState()

ObjectDataSourceView Gör att objektet spårar ändringar i visningstillståndet så att ändringarna kan lagras i ViewState objektet för kontrollen och sparas mellan begäranden för samma sida.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Utför en asynkron uppdateringsåtgärd i listan över data som DataSourceView objektet representerar.

(Ärvd från DataSourceView)
Update(IDictionary, IDictionary, IDictionary)

Utför en uppdateringsåtgärd genom att anropa den metod som identifieras av UpdateMethod egenskapen och använda parametrar som anges i keys, valueseller oldValues samlingarna.

Händelser

Name Description
DataSourceViewChanged

Inträffar när datakällans vy har ändrats.

(Ärvd från DataSourceView)
Deleted

Inträffar när en Delete åtgärd har slutförts.
Deleting

Inträffar före en Delete åtgärd.
Filtering

Inträffar före en filteråtgärd.
Inserted

Inträffar när en Insert åtgärd har slutförts.
Inserting

Inträffar före en Insert åtgärd.
ObjectCreated

Inträffar när objektet ObjectDataSourceView skapar en instans av den typ som identifieras av TypeName egenskapen.
ObjectCreating

Inträffar innan objektet ObjectDataSourceView skapar en instans av den typ som identifieras av TypeName egenskapen.
ObjectDisposing

Inträffar när objektet ObjectDataSourceView tar bort en instans av ett objekt som det har skapat.
Selected

Inträffar när en datahämtningsåtgärd har slutförts.
Selecting

Inträffar innan en datahämtningsåtgärd.
Updated

Inträffar när en Update åtgärd har slutförts.
Updating

Inträffar före en Update åtgärd.

Explicita gränssnittsimplementeringar

Name Description
IStateManager.IsTrackingViewState

En beskrivning av den här medlemmen finns i IsTrackingViewState.
IStateManager.LoadViewState(Object)

En beskrivning av den här medlemmen finns i LoadViewState(Object).
IStateManager.SaveViewState()

En beskrivning av den här medlemmen finns i SaveViewState().
IStateManager.TrackViewState()

En beskrivning av den här medlemmen finns i TrackViewState().

Gäller för

Se även