ConnectionStringEditor Classe

  • Référence

Définition

Espace de noms:
System.Web.UI.Design
Assembly:
System.Design.dll

Fournit une classe de base pour une interface utilisateur afin de sélectionner et modifier une propriété de type chaîne de connexion au moment du design.

public ref class ConnectionStringEditor : System::Drawing::Design::UITypeEditor
public class ConnectionStringEditor : System.Drawing.Design.UITypeEditor
type ConnectionStringEditor = class
    inherit UITypeEditor
Public Class ConnectionStringEditor
Inherits UITypeEditor
Héritage
Object
UITypeEditor
ConnectionStringEditor
Dérivé

Exemples

L’exemple de code suivant montre comment associer une instance de la ConnectionStringEditor classe à une propriété contenue dans un contrôle personnalisé. Lorsque la propriété de contrôle est modifiée dans l’aire de conception, la ConnectionStringEditor classe fournit l’interface utilisateur pour sélectionner et modifier une chaîne de connexion pour la valeur de la propriété.

// Define a custom class derived from the SqlDataSource Web control. 
public class SqlDataSourceWithBackup : SqlDataSource
{
    private string _alternateConnectionString;

    // Define an alternate connection string, which could be used
    // as a fallback value if the primary connection string fails.
    
    // The EditorAttribute indicates the property can
    // be edited at design-time with the ConnectionStringEditor class.
    [
      DefaultValue(""),
      EditorAttribute(typeof(System.Web.UI.Design.ConnectionStringEditor),
                     typeof(System.Drawing.Design.UITypeEditor)),
      Category("Data"),
      Description("The alternate connection string.")
    ]
    public string AlternateConnectionString
    {
        get
        {
            return _alternateConnectionString;
        }
        set
        {
            _alternateConnectionString = value;
        }
    }
}

' Define a custom class derived from the SqlDataSource Web control. 
Public Class SqlDataSourceWithBackup
    Inherits SqlDataSource

    Private _alternateConnectionString As String

    ' Define an alternate connection string, which could be used
    ' as a fallback value if the primary connection string fails.

    ' The EditorAttribute indicates the property can
    ' be edited at design-time with the ConnectionStringEditor class.
    <DefaultValue(""), _
     EditorAttribute(GetType(System.Web.UI.Design.ConnectionStringEditor), _
         GetType(System.Drawing.Design.UITypeEditor)), _
     Category("Data"), _
     Description("The alternate connection string.")> _
   Public Property AlternateConnectionString() As String

        Get
            Return _alternateConnectionString
        End Get
        Set(ByVal value As String)
            _alternateConnectionString = value
        End Set
    End Property

End Class

Remarques

Une instance de la ConnectionStringEditor classe est un UITypeEditor objet qui peut être utilisé au moment du design pour sélectionner et modifier une expression de chaîne de connexion et affecter l’expression à une propriété de contrôle. Par exemple, le SqlDataSource contrôle utilise la ConnectionStringEditor classe au moment du design pour définir la valeur de la ConnectionString propriété.

Utilisez l’attribut EditorAttribute pour associer la ConnectionStringEditor propriété. Lorsque la propriété associée est modifiée sur l’aire de conception, l’hôte du concepteur appelle la EditValue méthode. La EditValue méthode affiche une interface utilisateur pour créer l’expression de chaîne de connexion et retourne la chaîne de connexion sélectionnée par l’utilisateur. La GetEditStyle méthode indique le style d’affichage de l’interface utilisateur.

Constructeurs

ConnectionStringEditor()

Initialise une nouvelle instance de la classe ConnectionStringEditor.

Propriétés

IsDropDownResizable

Obtient une valeur indiquant si les éditeurs déroulants doivent être redimensionnables par l’utilisateur.

(Hérité de UITypeEditor)

Méthodes

EditValue(IServiceProvider, Object)

Modifie la valeur de l'objet spécifié à l'aide du style d'éditeur fourni par la méthode GetEditStyle().

(Hérité de UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)

Modifie la valeur de l'objet spécifié à l'aide du fournisseur de services et du contexte spécifiés.
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetEditStyle()

Obtient le style de l'éditeur utilisé par la méthode EditValue(IServiceProvider, Object).

(Hérité de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

Retourne le style de modification qui est associé à l'éditeur de chaîne de connexion pour le contexte spécifié.
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetPaintValueSupported()

Indique si cet éditeur permet de peindre une représentation de la valeur d'un objet.

(Hérité de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Indique si le contexte spécifié permet de peindre une représentation de la valeur d'un objet dans le contexte spécifié.

(Hérité de UITypeEditor)
GetProviderName(Object)

Retourne le nom du fournisseur pour l''instance fournie de la classe ConnectionStringEditor.
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
PaintValue(Object, Graphics, Rectangle)

Peint une représentation de la valeur de l'objet spécifié sur la toile spécifiée.

(Hérité de UITypeEditor)
PaintValue(PaintValueEventArgs)

Peint une représentation de la valeur d'un objet à l'aide du PaintValueEventArgs spécifié.

(Hérité de UITypeEditor)
SetProviderName(Object, DesignerDataConnection)

Place le nom du fournisseur sur l'instance spécifiée de la classe ConnectionStringEditor.
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi