UnauthorizedWebPart 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.
Służy do tworzenia obiektu zastępczego za każdym razem, gdy WebPartManager metoda kontrolki IsAuthorized zwraca false dla kontrolki WebPart . Klasa ta nie może być dziedziczona.
public ref class UnauthorizedWebPart sealed : System::Web::UI::WebControls::WebParts::ProxyWebPartpublic sealed class UnauthorizedWebPart : System.Web.UI.WebControls.WebParts.ProxyWebParttype UnauthorizedWebPart = class
inherit ProxyWebPartPublic NotInheritable Class UnauthorizedWebPart
Inherits ProxyWebPart- Dziedziczenie
Przykłady
Poniższy przykład kodu pokazuje użycie kontrolki UnauthorizedWebPart .
Pierwsza część przykładu kodu to niestandardowa WebPartManager kontrolka, która zastępuje metodę IsAuthorized(WebPart) tworzenia niestandardowych kryteriów autoryzacji. Każda WebPart kontrolka, która ma właściwość AuthorizationFilter ustawioną na określoną wartość lub jakąkolwiek kontrolkę, która nie ma przypisanej wartości do właściwości, zostanie autoryzowana, a kontrolki, które nie spełnia tych kryteriów, nie zostaną autoryzowane.
using System;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
namespace Samples.AspNet.CS.Controls
{
public class MyManagerAuthorize : WebPartManager
{
public override bool IsAuthorized(Type type, string path, string authorizationFilter, bool isShared)
{
if (!String.IsNullOrEmpty(authorizationFilter))
{
if (authorizationFilter == "admin")
return true;
else
return false;
}
else
{
return true;
}
}
}
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyManagerAuthorize
Inherits WebPartManager
Public Overrides Function IsAuthorized(ByVal type As Type, _
ByVal path As String, ByVal authorizationFilter As String, _
ByVal isShared As Boolean) As Boolean
If Not String.IsNullOrEmpty(authorizationFilter) Then
If authorizationFilter = "admin" Then
Return True
Else
Return False
End If
Else
Return True
End If
End Function
End Class
End Namespace
Drugą częścią przykładu kodu jest strona sieci Web, która hostuje kontrolkę niestandardową WebPartManager . W elemecie <asp:webpartzone> zadeklarowane są trzy statyczne kontrolki serwera. Chociaż te kontrolki nie są w rzeczywistości WebPart kontrolkami, zostaną one opakowane z obiektem GenericWebPart w czasie wykonywania, dzięki czemu można traktować je jako WebPart kontrolki, a tym samym przypisywać wartości do ich AuthorizationFilter właściwości. Zwróć uwagę, że kontrolka BulletedList ma ustawiony filtr na wartość, która powinna umożliwić jej autoryzację, zgodnie z kryteriami w kontrolce niestandardowej WebPartManager . Kontrolka Label ma wartość filtru, która powinna spowodować, że nie zostanie autoryzowana. Kontrolka Calendar nie przypisuje wartości do właściwości, dlatego domyślnie powinna być autoryzowana.
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
foreach (WebPart part in mgr1.WebParts)
{
if (mgr1.IsAuthorized(part))
part.ExportMode = WebPartExportMode.All;
}
}
protected void Button1_Click(object sender, EventArgs e)
{
Label2.Text = String.Empty;
foreach (WebPart part in mgr1.WebParts)
Label2.Text += part.ID + "<br />";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:MyManagerAuthorize ID="mgr1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
AuthorizationFilter="user" />
<asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="List WebPart Controls" OnClick="Button1_Click" />
<br />
<asp:Label ID="Label2" runat="server"
Text="" />
</div>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ Register Namespace="Samples.AspNet.VB.Controls"
TagPrefix="aspSample"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
Dim part As WebPart
For Each part In mgr1.WebParts
If mgr1.IsAuthorized(part) Then
part.ExportMode = WebPartExportMode.All
End If
Next
End Sub
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
Label2.Text = String.Empty
Dim part As WebPart
For Each part In mgr1.WebParts
Label2.Text += part.ID & "<br />"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:MyManagerAuthorize ID="mgr1" runat="server" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
AuthorizationFilter="user" />
<asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="List WebPart Controls" OnClick="Button1_Click" />
<br />
<asp:Label ID="Label2" runat="server"
Text="" />
</div>
</form>
</body>
</html>
Trzecią częścią przykładu kodu jest ustawienie, które należy dodać w pliku Web.config, aby umożliwić eksportowanie plików opisu składników Web Part. Upewnij się, że masz plik Web.config w tym samym katalogu co strona sieci Web dla tego przykładu kodu. <system.web> W sekcji upewnij się, że istnieje <webParts> element z atrybutem ustawionym enableExport na true, jak w poniższym znaczniku.
<webParts enableExport="true">
...
</webParts>
Załaduj stronę w przeglądarce i zwróć uwagę, że BulletedList kontrolki i Calendar są renderowane zgodnie z oczekiwaniami, ale kontrolka Label nie jest renderowana, ponieważ nie została autoryzowana. Kliknięcie przycisku Kontrolki składników Web Part listy powoduje WebPartManager wyświetlenie listy identyfikatorów wszystkich kontrolek w kolekcji WebParts . Należy pamiętać, że identyfikator kontrolki Label jest wyświetlany, udowadniając, że UnauthorizedWebPart kontrolka została dodana do drzewa kontrolek strony w celu przechowywania jej miejsca, mimo że etykieta nie jest renderowana na stronie.
Uwagi
Zestaw kontrolek składników Web Part udostępnia mechanizm autoryzacji do określania, czy poszczególne WebPart kontrolki można dodać do strony. Deweloperzy mogą opcjonalnie przypisać dowolny ciąg do AuthorizationFilter właściwości kontrolki WebPart . Gdy kontrolka WebPartManager dodaje kontrolki do strony, sprawdza tę wartość filtru względem kryteriów ustawionych przez dewelopera przy użyciu IsAuthorized metody i zwraca false , jeśli kontrolka nie jest autoryzowana.
Uwaga
Ten mechanizm współpracuje również z kontrolkami serwera i kontrolkami użytkownika umieszczonymi w WebPartZoneBase strefach, ponieważ te kontrolki są opakowane obiektem GenericWebPart w czasie wykonywania, a ten obiekt dziedziczy AuthorizationFilter właściwość.
Gdy kontrolka WebPart nie jest autoryzowana, WebPartManager kontrolka wstawia kontrolkę UnauthorizedWebPart do drzewa kontrolnego strony zamiast nieautoryzowanej kontrolki. Kontrolka UnauthorizedWebPart w drzewie sterowania zastrzega sobie pozycję nieautoryzowanej kontrolki na stronie i uniemożliwia utratę danych personalizacji, które użytkownik mógł wcześniej zastosować do WebPart kontrolki.
Kontrolka UnauthorizedWebPart nigdy nie jest wyświetlana na stronie, w której jest wstawiona, ani nie jest wyświetlana w kodzie źródłowym renderowanej strony. Deweloperzy mogą zweryfikować jego obecność w drzewie kontrolek strony, sprawdzając WebParts właściwość kontrolki WebPartManager .
Konstruktory
| UnauthorizedWebPart(String, String, String, String) |
Inicjuje nowe wystąpienie kontrolki UnauthorizedWebPart , wywoływane, gdy autoryzacja dynamiczna WebPart (serwer lub kontrola użytkownika) kończy się niepowodzeniem. |
| UnauthorizedWebPart(WebPart) |
Inicjuje nowe wystąpienie kontrolki UnauthorizedWebPart , wywoływane, gdy autoryzacja nie powiedzie się statycznej WebPart kontrolki (serwera lub kontrolki użytkownika). |
Właściwości
| AccessKey |
Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl) |
| Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
| AllowClose |
Pobiera lub ustawia wartość wskazującą, czy użytkownik końcowy może zamknąć kontrolkę WebPart na stronie sieci Web. (Odziedziczone po WebPart) |
| AllowConnect |
Pobiera lub ustawia wartość, która wskazuje, czy kontrolka WebPart umożliwia innym kontrolkom tworzenie z nim połączeń. (Odziedziczone po WebPart) |
| AllowEdit |
Pobiera lub ustawia wartość wskazującą, czy użytkownik końcowy może zmodyfikować kontrolkę WebPart za pomocą interfejsu użytkownika dostarczonego przez co najmniej jedną EditorPart kontrolkę. (Odziedziczone po WebPart) |
| AllowHide |
Pobiera lub ustawia wartość wskazującą, czy użytkownicy końcowi mogą ukryć kontrolkę WebPart . (Odziedziczone po WebPart) |
| AllowMinimize |
Pobiera lub ustawia wartość wskazującą, czy użytkownicy końcowi mogą zminimalizować WebPart kontrolę. (Odziedziczone po WebPart) |
| AllowZoneChange |
Pobiera lub ustawia wartość wskazującą, czy użytkownik może przenosić kontrolkę WebPart między strefami WebPartZoneBase . (Odziedziczone po WebPart) |
| AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
| Attributes |
Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl) |
| AuthorizationFilter |
Pobiera lub ustawia dowolny ciąg w celu określenia, czy kontrolka WebPart ma zostać dodana do strony. (Odziedziczone po WebPart) |
| BackColor |
Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BackImageUrl |
Pobiera lub ustawia adres URL obrazu tła dla kontrolki panelu. (Odziedziczone po Panel) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control) |
| BorderColor |
Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl) |
| BorderStyle |
Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BorderWidth |
Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| CatalogIconImageUrl |
Pobiera lub ustawia adres URL na obraz reprezentujący kontrolkę składników Web Part w katalogu kontrolek. (Odziedziczone po WebPart) |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control) |
| ChromeState |
Pobiera lub ustawia, czy kontrolka części jest w stanie zminimalizowanym, czy normalnym. (Odziedziczone po WebPart) |
| ChromeType |
Pobiera lub ustawia typ obramowania, który zawiera kontrolkę składników Web Part. (Odziedziczone po WebPart) |
| ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
| ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości. (Odziedziczone po Control) |
| ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
| ConnectErrorMessage |
Otrzymuje komunikat o błędzie wyświetlany użytkownikom, jeśli podczas procesu połączenia wystąpią błędy. (Odziedziczone po WebPart) |
| Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
| Controls |
ControlCollection Pobiera obiekt, który zawiera kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Part) |
| ControlStyle |
Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| ControlStyleCreated |
Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości . Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| CssClass |
Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl) |
| 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) |
| DefaultButton |
Pobiera lub ustawia identyfikator domyślnego przycisku, który znajduje się w kontrolce Panel . (Odziedziczone po Panel) |
| Description |
Pobiera lub ustawia krótką frazę, która podsumowuje działanie kontrolki części do użycia w etykietkach narzędzi i katalogach kontrolek części. (Odziedziczone po WebPart) |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| Direction |
Pobiera lub ustawia kierunek poziomy przepływa zawartości w kontrolce. (Odziedziczone po WebPart) |
| DisplayTitle |
Pobiera ciąg zawierający pełny tekst tytułu wyświetlany na pasku tytułu wystąpienia kontrolki WebPart . (Odziedziczone po WebPart) |
| Enabled |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl) |
| EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl) |
| 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 żądającego. (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) |
| ExportMode |
Pobiera lub ustawia, czy wszystkie, niektóre lub żadne WebPart właściwości kontrolki nie mogą być eksportowane. (Odziedziczone po WebPart) |
| Font |
Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl) |
| ForeColor |
Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| GenericWebPartID |
Pobiera wartość ID właściwości z ogólnej kontrolki składników Web Part zastąpionej przez kontrolkę składników Web Part serwera proxy. (Odziedziczone po ProxyWebPart) |
| GroupingText |
Pobiera lub ustawia podpis dla grupy kontrolek znajdujących się w kontrolce panelu. (Odziedziczone po Panel) |
| HasAttributes |
Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl) |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| HasSharedData |
Pobiera wartość wskazującą, czy kontrolka WebPart ma skojarzone z nią jakiekolwiek udostępnione dane personalizacji. (Odziedziczone po WebPart) |
| HasUserData |
Pobiera wartość wskazującą, czy kontrolka WebPart ma skojarzone z nią dane personalizacji użytkownika. (Odziedziczone po WebPart) |
| Height |
Pobiera lub ustawia wysokość strefy. (Odziedziczone po WebPart) |
| HelpMode |
Pobiera lub ustawia typ interfejsu użytkownika używanego do wyświetlania zawartości Pomocy dla kontrolki WebPart . (Odziedziczone po WebPart) |
| HelpUrl |
Pobiera lub ustawia adres URL pliku Pomocy dla kontrolki WebPart . (Odziedziczone po WebPart) |
| Hidden |
Pobiera lub ustawia wartość wskazującą, czy kontrolka WebPart jest wyświetlana na stronie sieci Web. (Odziedziczone po WebPart) |
| HorizontalAlign |
Pobiera lub ustawia wyrównanie w poziomie zawartości w panelu. (Odziedziczone po Panel) |
| ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki składników Web Part. (Odziedziczone po ProxyWebPart) |
| IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
| ImportErrorMessage |
Pobiera lub ustawia komunikat o błędzie, który jest używany, jeśli wystąpią błędy podczas importowania WebPart kontrolki. (Odziedziczone po WebPart) |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsClosed |
Pobiera wartość wskazującą, czy kontrolka WebPart jest obecnie zamknięta na stronie składników Web Part. (Odziedziczone po WebPart) |
| IsEnabled |
Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl) |
| IsShared |
Pobiera wartość wskazującą, czy kontrolka WebPart jest współużytkowana, co oznacza, że jest ona widoczna dla wszystkich użytkowników strony składników Web Part. (Odziedziczone po WebPart) |
| IsStandalone |
Pobiera wartość wskazującą, czy WebPart kontrolka jest autonomiczna, co oznacza, że nie jest ona zawarta w WebPartZoneBase strefie. (Odziedziczone po WebPart) |
| IsStatic |
Pobiera wartość wskazującą, czy WebPart kontrolka jest statyczną kontrolką, co oznacza, że kontrolka jest zadeklarowana w znacznikach strony składników Web Part i nie jest dodawana do strony programowo. (Odziedziczone po WebPart) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control) |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
| OriginalID |
Pobiera kontrolkę ID składników Web Part zastąpioną przez kontrolkę składników Web Part serwera proxy. (Odziedziczone po ProxyWebPart) |
| OriginalPath |
Pobiera ścieżkę do zastępowanej kontrolki użytkownika. (Odziedziczone po ProxyWebPart) |
| OriginalTypeName |
Pobiera kontrolkę Type składników Web Part zastąpioną przez kontrolkę składników Web Part serwera proxy. (Odziedziczone po ProxyWebPart) |
| Page |
Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control) |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| ScrollBars |
Pobiera lub ustawia widoczność i położenie pasków przewijania w kontrolce Panel . (Odziedziczone po Panel) |
| 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 w kontrolce. (Odziedziczone po WebControl) |
| Style |
Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu w zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| Subtitle |
Pobiera ciąg połączony z wartością Title właściwości, aby utworzyć pełny tytuł kontrolki WebPart . (Odziedziczone po WebPart) |
| SupportsDisabledAttribute |
Pobiera wartość wskazującą, czy kontrolka powinna ustawić |
| TabIndex |
Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| TagKey |
Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontrolce serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| TagName |
Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| Title |
Pobiera lub ustawia tytuł kontrolki części. (Odziedziczone po WebPart) |
| TitleIconImageUrl |
Pobiera lub ustawia adres URL obrazu używanego do reprezentowania kontrolki składników Web Part na pasku tytułu kontrolki. (Odziedziczone po WebPart) |
| TitleUrl |
Pobiera lub ustawia adres URL na dodatkowe informacje o kontrolce WebPart . (Odziedziczone po WebPart) |
| ToolTip |
Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl) |
| 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) |
| Verbs |
Pobiera kolekcję niestandardowych czasowników skojarzonych z kontrolką WebPart . (Odziedziczone po WebPart) |
| ViewState |
Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control) |
| WebBrowsableObject |
Pobiera odwołanie do kontrolki, WebPart aby umożliwić jej edycję za pomocą kontrolek niestandardowych EditorPart . (Odziedziczone po WebPart) |
| WebPartManager |
Pobiera odwołanie do kontrolki WebPartManager skojarzonej z wystąpieniem kontrolki WebPart . (Odziedziczone po WebPart) |
| Width |
Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebPart) |
| Wrap |
Pobiera lub ustawia wartość wskazującą, czy zawartość opakowuje się w panelu. (Odziedziczone po Panel) |
| Zone |
Pobiera strefę WebPartZoneBase , która obecnie zawiera kontrolkę WebPart . (Odziedziczone po WebPart) |
| ZoneIndex |
Pobiera pozycję indeksu WebPart kontrolki w jej strefie. (Odziedziczone po WebPart) |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Dodaje informacje o obrazie tła, wyrównaniu, zawijeniu i kierunku do listy atrybutów do renderowania. (Odziedziczone po Panel) |
| AddedControl(Control, Int32) |
Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
| ApplyStyle(Style) |
Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie czasu projektowania danych renderowania. (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 kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie kontroli 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 Inherit. (Odziedziczone po Control) |
| CopyBaseAttributes(WebControl) |
Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| CreateChildControls() |
Wywoływana przez platformę stron 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 Control) |
| CreateControlStyle() |
Tworzy obiekt stylu, który jest używany wewnętrznie przez kontrolkę Panel w celu zaimplementowania wszystkich właściwości pokrewnych stylu. (Odziedziczone po Panel) |
| CreateEditorParts() |
Zwraca kolekcję kontrolek niestandardowych EditorPart , których można użyć do edycji WebPart kontrolki w trybie edycji. (Odziedziczone po WebPart) |
| DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po Part) |
| DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding . (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Dispose() |
Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie czasu projektowania danych renderowania. (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 Control) |
| GetDesignModeState() |
Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| 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 bieżące wystąpienie. (Odziedziczone po Object) |
| GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
| HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
| HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
| IsLiteralContent() |
Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control) |
| LoadControlState(Object) |
Przesłonięcia LoadControlState(Object) , aby zapobiec ładowaniu wcześniej zapisanego ProxyWebPart stanu dla obiektu. (Odziedziczone po ProxyWebPart) |
| LoadViewState(Object) |
Przesłonięcia LoadViewState(Object) , aby zapobiec ładowaniu wcześniej zapisanego ProxyWebPart stanu widoku dla obiektu. (Odziedziczone po ProxyWebPart) |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| MergeStyle(Style) |
Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control) |
| OnClosing(EventArgs) |
Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi po WebPart zamknięciu kontrolki na stronie składników Web Part. (Odziedziczone po WebPart) |
| OnConnectModeChanged(EventArgs) |
Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi po WebPart rozpoczęciu lub zakończeniu procesu nawiązywania połączenia z innymi kontrolkami. (Odziedziczone po WebPart) |
| OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnDeleting(EventArgs) |
Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi, gdy kontrolka WebPart zostanie trwale usunięta ze strony składników Web Part. (Odziedziczone po WebPart) |
| OnEditModeChanged(EventArgs) |
Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi podczas WebPart wprowadzania lub opuszczania trybu edycji. (Odziedziczone po WebPart) |
| 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) |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Stream Pobiera element 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 Controls z kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Renderuje kontrolkę dla określonego składnika zapisywania HTML. (Odziedziczone po WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Renderuje tag otwierania HTML kontrolki Panel do określonego składnika zapisywania. (Odziedziczone po Panel) |
| RenderChildren(HtmlTextWriter) |
Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderContents(HtmlTextWriter) |
Renderuje zawartość kontrolki dla określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| 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 Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control) |
| RenderEndTag(HtmlTextWriter) |
Renderuje tag zamykający HTML kontrolki Panel do określonego składnika zapisywania. (Odziedziczone po Panel) |
| ResolveAdapter() |
Pobiera kartę kontrolną 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) |
| SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po ProxyWebPart) |
| SaveViewState() |
Zapisuje dowolny stan, który został zmodyfikowany po TrackViewState() wywołaniu metody. (Odziedziczone po ProxyWebPart) |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetPersonalizationDirty() |
Ustawia flagę wskazującą, że dane personalizacji uległy zmianie dla bieżącego WebPart wystąpienia kontrolki. (Odziedziczone po WebPart) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość 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, że kontrolka będzie śledzić zmiany stanu widoku, dzięki czemu mogą być przechowywane we właściwości obiektu ViewState . (Odziedziczone po WebPart) |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| Disposed |
Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona 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) |
| Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
Jawne implementacje interfejsu
| IAttributeAccessor.GetAttribute(String) |
Pobiera atrybut kontrolki sieci Web o określonej nazwie. (Odziedziczone po WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Umożliwia deweloperowi projektanta kontrolki części złożonej ponowne utworzenie kontrolek podrzędnych kontrolki kontrolki na powierzchni projektowej. (Odziedziczone po Part) |
| 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 członka, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego członka, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego członka, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego członka, zobacz HasDataBindings. (Odziedziczone po Control) |
| IExpressionsAccessor.Expressions |
Aby uzyskać opis tego członka, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego członka, zobacz HasExpressions. (Odziedziczone po Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Aby uzyskać opis tego członka, 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(INamingContainer) |
Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych. |
| GetMetaTable(INamingContainer) |
Pobiera metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable) |
Ustawia metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
| EnableDynamicData(INamingContainer, Type) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, Object) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
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