Partager via

ConnectionStringEditor Classe

Définition

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

Fournit une classe de base pour une interface utilisateur permettant de sélectionner et de modifier une propriété de 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 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 générer 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

Nom Description
ConnectionStringEditor()

Initialise une nouvelle instance de la classe ConnectionStringEditor.

Propriétés

Nom Description
IsDropDownResizable

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

(Hérité de UITypeEditor)

Méthodes

Nom Description
EditValue(IServiceProvider, Object)

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

(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 d’éditeur utilisé par la EditValue(IServiceProvider, Object) méthode.

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

Retourne le style d’édition associé à l’éditeur de chaîne de connexion pour le contexte spécifié.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetPaintValueSupported()

Indique si cet éditeur prend en charge la peinture d’une représentation de la valeur d’un objet.

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

Indique si le contexte spécifié prend en charge la peinture d’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 ConnectionStringEditor classe.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

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

Peint une représentation de la valeur de l’objet spécifié dans le canevas spécifié.

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

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

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

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

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

(Hérité de Object)

S’applique à

Voir aussi