XmlDataSource 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.
Reprezentuje źródło danych XML do kontrolek powiązanych z danymi.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Dziedziczenie
- Atrybuty
- Implementuje
Przykłady
Ten rozdział zawiera dwa przykłady kodu. Pierwszy przykład kodu pokazuje, jak używać kontrolki XmlDataSource z kontrolką TreeView do wyświetlania danych XML z przykładowego pliku XML. W drugim przykładzie pokazano, jak używać kontrolki XmlDataSource z kontrolką szablonu Repeater do wyświetlania danych XML.
W poniższym przykładzie kodu pokazano, jak używać kontrolki XmlDataSource z kontrolką TreeView do wyświetlania danych XML. XmlDataSource Ładuje dane XML z pliku XML zidentyfikowanego przez DataFile właściwość.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
Plik XML w przykładzie kodu zawiera następujące dane:
<books>
<computerbooks>
<book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
<book title="Straight Talk About Computers" author="Dean Straight"/>
<book title="You Can Combat Computer Stress!" author="Marjorie Green"/>
</computerbooks>
<cookbooks>
<book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
</cookbooks>
</books>
W poniższym przykładzie kodu pokazano, jak używać kontrolki XmlDataSource z kontrolką szablonu Repeater do wyświetlania danych XML. Kontrolka Repeater używa wyrażenia powiązania danych XPath do powiązania z elementami danych w dokumencie XML, który XmlDataSource reprezentuje. Aby uzyskać więcej informacji na temat XPath składni powiązania danych i XPathSelect ich powiązania, zobacz klasę XPathBinder .
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
Plik XML w przykładzie kodu zawiera następujące dane:
<?xml version="1.0" encoding="iso-8859-1"?>
<orders>
<order>
<customer id="12345" />
<customername>
<firstn>John</firstn>
<lastn>Smith</lastn>
</customername>
<transaction id="12345" />
<shipaddress>
<address1>1234 Tenth Avenue</address1>
<city>Bellevue</city>
<state>Washington</state>
<zip>98001</zip>
</shipaddress>
<summary>
<item dept="tools">screwdriver</item>
<item dept="tools">hammer</item>
<item dept="plumbing">fixture</item>
</summary>
</order>
</orders>
Uwagi
W tym temacie:
Wprowadzenie
Kontrolka to kontrolka XmlDataSource źródła danych, która przedstawia dane XML do kontrolek powiązanych z danymi. Kontrolka XmlDataSource może być używana przez kontrolki powiązane z danymi do wyświetlania zarówno danych hierarchicznych, jak i tabelarycznych. Kontrolka XmlDataSource jest zwykle używana do wyświetlania hierarchicznych danych XML w scenariuszach tylko do odczytu. Ponieważ kontrolka XmlDataSource rozszerza klasę HierarchicalDataSourceControl , działa z danymi hierarchicznymi. Kontrolka XmlDataSource implementuje IDataSource również interfejs i współpracuje z danymi tabelarycznymi lub listowymi.
Uwaga
W celach zabezpieczających żadna z XmlDataSource właściwości kontrolek nie jest przechowywana w stanie widoku. Ponieważ technicznie można dekodować zawartość stanu widoku na kliencie, przechowywanie poufnych informacji o strukturze danych lub jego zawartości może spowodować ujawnienie informacji o zagrożeniu ujawnieniem informacji. Należy pamiętać, że jeśli musisz przechowywać informacje, takie jak XPath właściwość w stanie widoku, możesz włączyć szyfrowanie w celu ochrony zawartości, ustawiając ViewStateEncryptionMode dyrektywę @ Page .
Deweloperzy stron używają kontrolki do wyświetlania XmlDataSource danych XML przy użyciu kontrolek powiązanych z danymi.
Źródła danych XML
Zazwyczaj XmlDataSource ładuje dane XML z pliku XML określonego DataFile przez właściwość . Dane XML mogą być również przechowywane bezpośrednio przez kontrolkę źródła danych w postaci ciągu przy użyciu Data właściwości . Jeśli chcesz przekształcić dane XML przed ich wyświetleniem przez kontrolkę związaną z danymi, możesz podać arkusz stylów języka XSL (Extensible Stylesheet Language) na potrzeby transformacji. Podobnie jak w przypadku danych XML, zwykle ładujesz arkusz stylów z pliku wskazanego TransformFile przez właściwość, ale można je również przechowywać w postaci ciągu bezpośrednio przy użyciu Transform właściwości .
Aktualizowanie danych XML
Kontrolka XmlDataSource jest często używana w scenariuszach danych tylko do odczytu, w których kontrolka powiązana z danymi wyświetla dane XML. Można jednak również użyć kontrolki do edytowania XmlDataSource danych XML. Aby edytować dane XML, wywołaj GetXmlDocument metodę , aby pobrać XmlDataDocument obiekt, który jest reprezentacją danych XML w pamięci. Możesz użyć modelu obiektów uwidocznionego przez XmlDataDocument obiekty i XmlNode , które zawiera, lub użyć wyrażenia filtrowania XPath, aby manipulować danymi w dokumencie. Po wprowadzeniu zmian w reprezentacji danych XML w pamięci można je zapisać na dysku, wywołując metodę Save .
Istnieją pewne ograniczenia dotyczące możliwości edytowania XmlDataSource kontrolki:
Dane XML muszą zostać załadowane z pliku XML wskazanego przez właściwość, a nie z wbudowanego DataFile kodu XML określonego Data we właściwości.
Nie można określić przekształcenia XSLT we właściwościach Transform lub TransformFile .
Metoda Save nie obsługuje współbieżnych operacji zapisywania według różnych żądań. Jeśli więcej niż jeden użytkownik edytuje plik XML za pośrednictwem elementu XmlDataSource, nie ma gwarancji, że wszyscy użytkownicy działają z tymi samymi danymi. Istnieje również możliwość Save niepowodzenia operacji z powodu tych samych problemów współbieżności.
Określanie przekształcenia XSL
Typową operacją wykonywaną przy użyciu danych XML jest przekształcanie ich z jednego zestawu danych XML na inny. Kontrolka XmlDataSource obsługuje przekształcenia XML z właściwościami Transform i TransformFile , które określają arkusz stylów XSL do zastosowania do danych XML przed przekazaniem do kontrolki powiązanej z danymi, oraz TransformArgumentList właściwość, która umożliwia podanie dynamicznych argumentów arkusza stylów XSLT do użycia przez arkusz stylów XSL podczas transformacji. Jeśli określisz wyrażenie filtrowania XPath przy użyciu XPath właściwości, zostanie ono zastosowane po zakończeniu transformacji.
Uwaga
Klasa XmlDataSource używa przestarzałej XslTransform klasy do wykonywania przekształceń XSL. Jeśli chcesz użyć funkcji arkusza stylów, które zostały wprowadzone po XslTransform wycofaniu klasy, zastosuj przekształcenia ręcznie przy użyciu XslCompiledTransform klasy.
Filtrowanie przy użyciu wyrażenia XPath
Domyślnie kontrolka XmlDataSource ładuje wszystkie dane XML w pliku XML zidentyfikowanym przez DataFile właściwość lub znalezione w tekście we Data właściwości, ale można filtrować dane przy użyciu wyrażenia XPath. Właściwość XPath obsługuje filtr składni XPath, który jest stosowany po załadowaniu i przekształceniu danych XML.
Buforowanie
W celach wydajności buforowanie jest domyślnie włączone dla kontrolki XmlDataSource . Otwieranie i odczytywanie pliku XML na serwerze za każdym razem, gdy żądana strona może zmniejszyć wydajność aplikacji. Buforowanie pozwala zmniejszyć obciążenie przetwarzania na serwerze kosztem pamięci na serwerze sieci Web; w większości przypadków jest to dobry kompromis. Właściwość XmlDataSource automatycznie buforuje dane, gdy EnableCaching właściwość jest ustawiona na truewartość , a CacheDuration właściwość jest ustawiona na liczbę sekund, w których pamięć podręczna przechowuje dane przed unieważnieniem pamięci podręcznej. Możesz użyć polecenia CacheExpirationPolicy , aby jeszcze bardziej dostosować zachowanie buforowania kontroli źródła danych.
Dodatkowe funkcje
W poniższej tabeli wymieniono dodatkowe funkcje obsługiwane przez kontrolkę XmlDataSource .
| Możliwość | Opis |
|---|---|
| Sortowanie | Kontrolka nie jest obsługiwana XmlDataSource . |
| Filtrowanie | Właściwość XPath może służyć do filtrowania danych XML przy użyciu odpowiedniego wyrażenia XPath. |
| Stronicowanie | Kontrolka nie jest obsługiwana XmlDataSource . |
| Aktualizowanie | Obsługiwane przez manipulowanie XmlDataDocument bezpośrednio, a następnie wywoływanie Save metody. |
| Usuwanie | Obsługiwane przez manipulowanie XmlDataDocument bezpośrednio, a następnie wywoływanie Save metody. |
| Wstawianie | Obsługiwane przez manipulowanie XmlDataDocument bezpośrednio, a następnie wywoływanie Save metody. |
| Buforowanie | Włączone domyślnie z właściwością ustawioną CacheDuration na 0 (nieskończoną) i właściwość ustawioną CacheExpirationPolicy na Absolute. |
Obiekt widoku danych
Ponieważ kontrolka XmlDataSource obsługuje kontrolki powiązane z danymi, które wyświetlają dane hierarchiczne, a także kontrolki wyświetlające dane tabelaryczne, kontrolka źródła danych obsługuje wiele typów obiektów widoku źródła danych na podstawowych danych XML. Kontrolka XmlDataSource pobiera pojedynczy nazwany XmlDataSourceView obiekt w przypadku użycia z kontrolką związaną z danymi, która wyświetla dane tabelaryczne. Metoda GetViewNames identyfikuje ten pojedynczy nazwany widok. W przypadku użycia z kontrolką powiązaną z danymi, która wyświetla dane hierarchiczne, XmlDataSource kontrolka pobiera dla XmlHierarchicalDataSourceView każdej unikatowej ścieżki hierarchicznej przekazanej GetHierarchicalView do metody.
Składnia deklaracyjna
<asp:XmlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
DataFile="string"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnTransforming="Transforming event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
TransformArgumentList="string"
TransformFile="string"
Visible="True|False"
XPath="string"
>
<Data>string</Data>
<Transform>string</Transform>
</asp:XmlDataSource>
Konstruktory
| XmlDataSource() |
Tworzy nowe wystąpienie klasy XmlDataSource. |
Właściwości
| Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
| AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control) |
| CacheDuration |
Pobiera lub ustawia czas w sekundach, przez który kontrola źródła danych buforuje pobrane dane. |
| CacheExpirationPolicy |
Pobiera lub ustawia zasady wygasania pamięci podręcznej, które są łączone z czasem trwania pamięci podręcznej w celu opisania zachowania buforowania pamięci podręcznej używanej przez kontrolkę źródła danych. |
| CacheKeyContext |
Pobiera lub ustawia wartość klucza pamięci podręcznej dla kontrolki źródła danych ze stanu widoku lub dodaje klucz pamięci podręcznej do wyświetlania stanu. |
| CacheKeyDependency |
Pobiera lub ustawia zależność klucza zdefiniowanego przez użytkownika, która jest połączona z wszystkimi obiektami pamięci podręcznej danych utworzonymi przez kontrolę źródła danych. Wszystkie obiekty pamięci podręcznej jawnie wygasają po wygaśnięciu klucza. |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control) |
| ClientID |
Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET. (Odziedziczone po HierarchicalDataSourceControl) |
| ClientIDMode |
Ta właściwość nie jest używana w przypadku kontrolek źródła danych. (Odziedziczone po HierarchicalDataSourceControl) |
| ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
| Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
| Controls |
ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po HierarchicalDataSourceControl) |
| Data |
Pobiera lub ustawia blok danych XML, z którymi wiąże się kontrolka źródła danych. |
| DataFile |
Określa nazwę pliku XML powiązanego ze źródłem danych. |
| DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
| DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| EnableCaching |
Pobiera lub ustawia wartość wskazującą, czy kontrolka XmlDataSource ma włączoną buforowanie danych. |
| EnableTheming |
Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy. (Odziedziczone po HierarchicalDataSourceControl) |
| EnableViewState |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie. (Odziedziczone po Control) |
| Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
| IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control) |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
| Page |
Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control) |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| Site |
Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
| SkinID |
Pobiera lub ustawia skórę do zastosowania do kontrolki HierarchicalDataSourceControl . (Odziedziczone po HierarchicalDataSourceControl) |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| Transform |
Pobiera lub ustawia blok danych języka XSL (Extensible Stylesheet Language), które definiują przekształcenie XSLT do wykonania na danych XML zarządzanych przez kontrolkę XmlDataSource . |
| TransformArgumentList |
Zawiera listę argumentów XSLT używanych z arkuszem stylów zdefiniowanym przez Transform właściwości lub TransformFile w celu przeprowadzenia transformacji danych XML. |
| TransformFile |
Określa nazwę pliku extensible Stylesheet Language (XSL) (xsl), który definiuje przekształcenie XSLT do wykonania na danych XML zarządzanych przez kontrolkę XmlDataSource . |
| UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
| ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
| ViewState |
Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb stanu widoku tej kontrolki. (Odziedziczone po Control) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie. (Odziedziczone po HierarchicalDataSourceControl) |
| XPath |
Określa wyrażenie XPath, które ma być stosowane do danych XML zawartych we Data właściwości lub przez plik XML wskazany przez DataFile właściwość. |
Metody
| AddedControl(Control, Int32) |
Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| BuildProfileTree(String, Boolean) |
Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control) |
| ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
| ClearChildControlState() |
Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control) |
| CreateChildControls() |
Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control) |
| CreateControlCollection() |
Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera. (Odziedziczone po HierarchicalDataSourceControl) |
| DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po Control) |
| DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Dispose() |
Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
| EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| FindControl(String) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego |
| FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
| Focus() |
Ustawia fokus wejściowy na kontrolkę. (Odziedziczone po HierarchicalDataSourceControl) |
| GetDesignModeState() |
Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetHierarchicalView(String) |
Pobiera obiekt widoku źródła danych dla kontrolki XmlDataSource . Parametr |
| GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
| GetXmlDocument() |
Ładuje dane XML do pamięci, bezpośrednio z bazowego magazynu danych lub z pamięci podręcznej XmlDataDocument i zwraca je w postaci obiektu. |
| HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po HierarchicalDataSourceControl) |
| HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control) |
| IsLiteralContent() |
Określa, czy kontrolka serwera przechowuje tylko zawartość literału. (Odziedziczone po Control) |
| LoadControlState(Object) |
Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control) |
| LoadViewState(Object) |
Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() . (Odziedziczone po Control) |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control) |
| OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnDataSourceChanged(EventArgs) |
DataSourceChanged Zgłasza zdarzenie. (Odziedziczone po HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Init Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnTransforming(EventArgs) |
Transforming Zgłasza zdarzenie przed XmlDataSource wykonaniem przekształcenia XSLT na danych XML kontrolki. |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
| RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderChildren(HtmlTextWriter) |
Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter) |
Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control) |
| ResolveAdapter() |
Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
| ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
| ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
| Save() |
Zapisuje dane XML przechowywane obecnie w pamięci przez kontrolkę XmlDataSource na dysku, jeśli właściwość jest ustawiona DataFile . |
| SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
| SaveViewState() |
Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej. (Odziedziczone po Control) |
| SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| SetTraceData(Object, Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| TrackViewState() |
Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości . (Odziedziczone po Control) |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| Disposed |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET. (Odziedziczone po Control) |
| Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
| Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
| PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
| Transforming |
Występuje przed zastosowaniem arkusza stylów zdefiniowanego Transform przez właściwość lub zidentyfikowaną przez TransformFile właściwość do danych XML. |
| Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
Jawne implementacje interfejsu
| IControlBuilderAccessor.ControlBuilder |
Aby uzyskać opis tego członka, zobacz ControlBuilder. (Odziedziczone po Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control) |
| IDataSource.DataSourceChanged |
Aby uzyskać opis tego elementu członkowskiego, zobacz DataSourceChanged. |
| IDataSource.GetView(String) |
Pobiera nazwany widok źródła danych skojarzony z kontrolą źródła danych. |
| IDataSource.GetViewNames() |
Aby uzyskać opis tego elementu członkowskiego, zobacz GetViewNames(). |
| IExpressionsAccessor.Expressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control) |
| IHierarchicalDataSource.DataSourceChanged |
Występuje, gdy obiekt HierarchicalDataSourceControl zmienił się w jakiś sposób, który ma wpływ na kontrolki powiązane z danymi. (Odziedziczone po HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Pobiera obiekt pomocnika widoku dla interfejsu IHierarchicalDataSource dla określonej ścieżki. (Odziedziczone po HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Aby uzyskać opis tego elementu członkowskiego, zobacz ContainsListCollection. |
| IListSource.GetList() |
Aby uzyskać opis tego elementu członkowskiego, zobacz GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control) |
Metody rozszerzania
| FindDataSourceControl(Control) |
Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki. |
| FindFieldTemplate(Control, String) |
Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki. |
| FindMetaTable(Control) |
Zwraca obiekt metatable dla kontrolki zawierającej dane. |
| GetDefaultValues(IDataSource) |
Pobiera kolekcję wartości domyślnych dla określonego źródła danych. |
| GetMetaTable(IDataSource) |
Pobiera metadane dla tabeli w określonym obiekcie źródła danych. |
| TryGetMetaTable(IDataSource, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
Dotyczy
Zobacz też
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla