DesignerRegion Klasse

Referenz

Definition

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert einen Bereich des Inhalts innerhalb des Entwurfszeitmarkups für das zugeordnete Steuerelement.

public ref class DesignerRegion : System::Web::UI::Design::DesignerObject

public class DesignerRegion : System.Web.UI.Design.DesignerObject

type DesignerRegion = class
    inherit DesignerObject

Public Class DesignerRegion
Inherits DesignerObject

Vererbung: Object

DesignerObject
DesignerRegion

Abgeleitet: System.Web.UI.Design.EditableDesignerRegion

Hinweise

Das DesignerRegion -Objekt stellt einen Inhaltsbereich innerhalb des Entwurfszeitmarkups dar, der von einer ControlDesigner -Implementierung generiert wird. Ein Steuerelemententwickler verwendet Designerbereiche in einer benutzerdefinierten ControlDesigner Implementierung, um separate Bereiche innerhalb des Entwurfszeitmarkups für das zugeordnete Steuerelement zu definieren und bearbeitungs- und Ereignisbehandlung für den Bereich bereitzustellen. Ein visueller Designer, z. B. Visual Studio 2005, kann Designerbereiche verwenden, um die separaten Bereiche eines Steuerelements auf der Entwurfsoberfläche anzuzeigen und Benutzerereignisse für den Bereich für den Steuerelement-Designer auszulösen. Designer Regionen können die Implementierung des Steuerelement-Designers vereinfachen, da viele regionsbasierte Features von den Basis-Designerklassen und dem visuellen Designer bereitgestellt werden.

Die DesignerRegion -Klasse stellt die Basisfunktionen für Designerbereiche bereit, z. B. die Möglichkeit, einen Bereich auf der Entwurfsoberfläche zu klicken, auszuwählen und hervorzuheben. Verwenden Sie ein DesignerRegion -Objekt in einer Steuerelement-Designer-Implementierung, um einen Bereich zu definieren, für den keine Bearbeitung erforderlich ist. Verwenden Sie die abgeleitete EditableDesignerRegion Klasse in einer Steuerelement-Designer-Implementierung, um einen Bereich mit bearbeitbarem Inhalt zur Entwurfszeit zu definieren. Verwenden Sie die abgeleitete TemplatedEditableDesignerRegion Klasse in einer Steuerelement-Designer-Implementierung, um einen bearbeitbaren Bereich zu definieren, der eine Vorlage in einem Steuerelement darstellt.

Um Regionen in einer Klasse zu unterstützen, die ControlDesignervon abgeleitet wird, überschreiben Sie die GetDesignTimeHtml -Methode, und fügen Sie der DesignerRegionCollection Auflistung ein oder mehrere initialisierte DesignerRegion Objekte hinzu. Optional können Sie Mausklicks in den Bereichen auf der Entwurfsoberfläche verarbeiten, indem Sie die OnClick -Methode überschreiben.

Verwenden Sie die Eigenschaften eines DesignerRegion -Objekts, um zu bestimmen, wie der Bereich vom visuellen Designer angezeigt wird. Überschreiben Sie die Selectable -Eigenschaft, um anzugeben, dass der Bereich vom Benutzer auf der Entwurfsoberfläche ausgewählt werden kann. Verwenden Sie die Highlight -Eigenschaft, um den Designerbereich im visuellen Designer hervorzuheben. Sie können beispielsweise einen Bereich markieren, nachdem ein Benutzer darauf geklickt hat, um ihn auszuwählen. Verwenden Sie die DisplayName Eigenschaften und Description , um zusätzliche Details zur Region zu speichern oder abzurufen. Insbesondere wird die Description -Eigenschaft vom visuellen Designer verwendet, um QuickInfo-Informationen anzuzeigen, wenn der Benutzer den Mauszeiger über den Designerbereich bewegt. Verwenden Sie die Designer -Eigenschaft, um auf die Methoden und Eigenschaften des Steuerelement-Designerobjekts zuzugreifen, das den Designerbereich enthält.

Konstruktoren

DesignerRegion(ControlDesigner, String)	Initialisiert eine neue Instanz der DesignerRegion-Klasse mit dem angegebenen Namen für einen Steuerelement-Designer.
DesignerRegion(ControlDesigner, String, Boolean)	Initialisiert eine neue Instanz der DesignerRegion-Klasse mit dem angegebenen Namen für einen Steuerelement-Designer und legt optional die Instanz als auswählbaren Bereich im Designer fest.

Felder

DesignerRegionAttributeName

Definiert den HTML-Attributnamen für einen Designerbereich.

Eigenschaften

Description	Ruft die Beschreibung für einen Designerbereich ab oder legt diese fest.
Designer	Ruft die zugeordnete Designerkomponente ab. (Geerbt von DesignerObject)
DisplayName	Ruft den benutzerfreundlichen Anzeigenamen für einen Designerbereich ab oder legt diesen fest.
EnsureSize	Ruft einen Wert ab, der angibt, ob die Bereichsgröße explizit vom Designhost für den Designerbereich festgelegt werden soll, oder legt diesen fest.
Highlight	Ruft einen Wert ab, der angibt, ob der Designerbereich auf der Entwurfsoberfläche hervorgehoben werden soll, oder legt diesen fest.
Name	Ruft den Namen des Objekts ab. (Geerbt von DesignerObject)
Properties	Ruft die Eigenschaften des Objekts ab. (Geerbt von DesignerObject)
Selectable	Ruft einen Wert ab, der angibt, ob der Designerbereich auf der Entwurfsoberfläche von Benutzern ausgewählt werden kann, oder legt diesen fest.
Selected	Ruft einen Wert ab, der angibt, ob der Designerbereich derzeit auf der Entwurfsoberfläche ausgewählt ist, oder legt diesen fest.
UserData	Ruft optionale Benutzerdaten ab, die dem Designerbereich zugeordnet werden sollen, oder legt diese fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBounds()	Ruft die Größe des Designerbereichs auf der Entwurfsoberfläche ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetService(Type)	Ruft einen Dienst vom Entwurfshost entsprechend dem bereitgestellten Typ ab. (Geerbt von DesignerObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IServiceProvider.GetService(Type)

Eine Beschreibung dieses Elements finden Sie unter GetService(Type).

(Geerbt von DesignerObject)

Erweiterungsmethoden

GetKeyedService<T>(IServiceProvider, Object)	Ruft einen Dienst vom Typ `T` aus ab IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Ruft eine Enumeration von Diensten vom Typ `serviceType` aus ab IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Ruft eine Enumeration von Diensten vom Typ `T` aus ab IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Ruft einen Dienst vom Typ `serviceType` aus ab IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Ruft einen Dienst vom Typ `T` aus ab IServiceProvider.
CreateAsyncScope(IServiceProvider)	Erstellt eine neue AsyncServiceScope-Schnittstelle, die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann.
CreateScope(IServiceProvider)	Erstellt eine neue IServiceScope-Schnittstelle, die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann.
GetRequiredService(IServiceProvider, Type)	Ruft einen Dienst vom Typ `serviceType` aus der IServiceProvider-Schnittstelle ab.
GetRequiredService<T>(IServiceProvider)	Ruft einen Dienst vom Typ `T` aus der IServiceProvider-Schnittstelle ab.
GetService<T>(IServiceProvider)	Ruft einen Dienst vom Typ `T` aus der IServiceProvider-Schnittstelle ab.
GetServices(IServiceProvider, Type)	Ruft eine Enumeration von Diensten vom Typ `serviceType` aus der IServiceProvider-Schnittstelle ab.
GetServices<T>(IServiceProvider)	Ruft eine Enumeration von Diensten vom Typ `T` aus der IServiceProvider-Schnittstelle ab.
GetFakeLogCollector(IServiceProvider)	Ruft das -Objekt ab, das An die gefälschte Protokollierung gesendete Protokolldatensätze sammelt.
GetFakeRedactionCollector(IServiceProvider)	Ruft den gefälschten Redactorsammler instance aus dem Abhängigkeitsinjektionscontainer ab.

Gilt für: