Freigeben über


DesignerRegion Klasse

Definition

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
DesignerRegion
Abgeleitet

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. Designerbereiche können die Implementierung eines 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 die gefälschte Redactor collector-Instanz aus dem Abhängigkeitsinjektionscontainer ab.

Gilt für:

Weitere Informationen