FormViewDesigner.GetDesignTimeHtml Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient le balisage utilisé pour afficher le contrôle associé au moment de la conception.
public:
override System::String ^ GetDesignTimeHtml();public override string GetDesignTimeHtml ();override this.GetDesignTimeHtml : unit -> stringPublic Overrides Function GetDesignTimeHtml () As StringRetours
String qui contient le balisage utilisé pour afficher FormView au moment de la conception.
Exemples
L’exemple de code suivant montre comment remplacer la GetDesignTimeHtml méthode dans une classe héritée de la FormViewDesigner classe pour modifier l’apparence du contrôle au moment du FormView design. L’exemple ajoute une nouvelle première ligne à la grille pour contenir la Caption propriété, si est Caption défini. Si la BorderStyle propriété du contrôle qui est dérivée de est FormView la NotSet valeur ou None , dessine GetDesignTimeHtml une bordure bleue en pointillés autour du contrôle pour rendre son étendue plus visible. L’exemple ne modifie pas l’apparence au moment de l’exécution du contrôle.
// Generate the design-time markup.
const string capTag = "caption";
const string trOpen = "tr><td colspan=9 align=center";
const string trClose = "td></tr";
public override string GetDesignTimeHtml()
{
// Make the full extent of the control more visible in the designer.
// If the border style is None or NotSet, change the border to
// a wide, blue, dashed line. Include the caption within the border.
MyFormView myGV = (MyFormView)Component;
string markup = null;
int charX;
// Check if the border style should be changed.
if (myGV.BorderStyle == BorderStyle.NotSet ||
myGV.BorderStyle == BorderStyle.None)
{
BorderStyle oldBorderStyle = myGV.BorderStyle;
Unit oldBorderWidth = myGV.BorderWidth;
Color oldBorderColor = myGV.BorderColor;
// Set the design-time properties and catch any exceptions.
try
{
myGV.BorderStyle = BorderStyle.Dashed;
myGV.BorderWidth = Unit.Pixel(3);
myGV.BorderColor = Color.Blue;
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
markup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the properties to their original settings.
myGV.BorderStyle = oldBorderStyle;
myGV.BorderWidth = oldBorderWidth;
myGV.BorderColor = oldBorderColor;
}
}
else
{
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
// Look for a <caption> tag.
if ((charX = markup.IndexOf(capTag)) > 0)
{
// Replace the first caption with
// "tr><td colspan=9 align=center".
// It is okay if the colspan exceeds the
// number of columns in the table.
markup = markup.Remove(charX,
capTag.Length).Insert(charX, trOpen);
// Replace the second caption with "td></tr".
if ((charX = markup.IndexOf(capTag, charX)) > 0)
markup = markup.Remove(charX,
capTag.Length).Insert(charX, trClose);
}
return markup;
} // GetDesignTimeHtml
' Generate the design-time markup.
Private Const capTag As String = "caption"
Private Const trOpen As String = "tr><td colspan=9 align=center"
Private Const trClose As String = "td></tr"
Public Overrides Function GetDesignTimeHtml() As String
' Make the full extent of the control more visible in the designer.
' If the border style is None or NotSet, change the border to
' a wide, blue, dashed line. Include the caption within the border.
Dim myGV As MyFormView = CType(Component, MyFormView)
Dim markup As String = Nothing
Dim charX As Integer
' Check if the border style should be changed.
If (myGV.BorderStyle = BorderStyle.NotSet Or _
myGV.BorderStyle = BorderStyle.None) Then
Dim oldBorderStyle As BorderStyle = myGV.BorderStyle
Dim oldBorderWidth As Unit = myGV.BorderWidth
Dim oldBorderColor As Color = myGV.BorderColor
' Set the design-time properties and catch any exceptions.
Try
myGV.BorderStyle = BorderStyle.Dashed
myGV.BorderWidth = Unit.Pixel(3)
myGV.BorderColor = Color.Blue
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
markup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the properties to their original settings.
myGV.BorderStyle = oldBorderStyle
myGV.BorderWidth = oldBorderWidth
myGV.BorderColor = oldBorderColor
End Try
Else
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
End If
' Look for a <caption> tag.
charX = markup.IndexOf(capTag)
If charX > 0 Then
' Replace the first caption with
' "tr><td colspan=9 align=center".
' It is okay if the colspan exceeds the
' number of columns in the table.
markup = markup.Remove(charX, _
capTag.Length).Insert(charX, trOpen)
' Replace the second caption with "td></tr".
charX = markup.IndexOf(capTag, charX)
If charX > 0 Then
markup = markup.Remove(charX, _
capTag.Length).Insert(charX, trClose)
End If
End If
Return markup
End Function ' GetDesignTimeHtml
Remarques
Si un modèle d’élément a été défini pour le FormView contrôle, la GetDesignTimeHtml méthode définit la DataKeyNames collection du contrôle sur un tableau vide String si le schéma de la source de données ne peut pas être obtenu. Actualise GetDesignTimeHtml l’objet TypeDescriptor pour forcer un appel à la PreFilterProperties méthode . appelle GetDesignTimeHtml ensuite la méthode de base pour générer le balisage.
Si aucun modèle d’élément n’a été défini pour le FormView contrôle, le GetDesignTimeHtml appelle la méthode pour générer le GetEmptyDesignTimeHtml balisage qui s’affiche dans un espace réservé.
Notes pour les héritiers
Si vous remplacez la GetDesignTimeHtml() méthode, veillez à appeler la méthode de base, car elle finit par passer par plusieurs niveaux de remplacement, appelle sur le FormView contrôle ou une copie du FormView contrôle pour générer le balisage.
