Freigeben über


Benutzerdefinierte Eigenschaften in Diagrammsteuerelementen

Jeder Diagrammtyp im Diagrammsteuerelement enthält einen Satz benutzerdefinierter Eigenschaften, mit denen das Erscheinungsbild des Diagramms angepasst werden kann. Benutzerdefinierte Eigenschaften werden mithilfe der CustomProperties-Eigenschaft der Series-Objekte sowie der zugeordneten DataPoint-Objekte implementiert.

Hinweis

Jede benutzerdefinierte Eigenschaft bezieht sich auf einen bestimmten Satz von Diagrammtypen.

Die benutzerdefinierten Eigenschaften des Diagrammsteuerelements weisen die folgenden Merkmale auf:

  • Abhängig vom Diagrammtyp können Sie gültige benutzerdefinierte Eigenschaften für die Series-Objekte des Diagramms und/oder die zugeordneten DataPoint-Objekte festlegen. Wenn eine benutzerdefinierte Eigenschaft sowohl auf die Series-Objekte als auch auf die DataPoint-Objekte angewendet wird, werden die benutzerdefinierten Eigenschaften, die für eine Reihe festgelegt sind, auf alle Datenpunkte innerhalb dieser Reihe angewendet.

  • Benutzerdefinierte Eigenschaften für DataPoint-Objekte haben eine höhere Priorität als benutzerdefinierte Eigenschaften für Series-Objekte. Wenn die gleiche benutzerdefinierte Eigenschaft für ein Series-Objekt und eines der zugeordneten DataPoint-Objekte festgelegt wird, hat die Einstellung für das DataPoint-Objekt Vorrang.

  • Bei den Namen von benutzerdefinierten Eigenschaften wird die Groß-/Kleinschreibung beachtet.

  • Die Werte von benutzerdefinierten Eigenschaften sind Zeichenfolgen.

  • Wenn der Wert einer benutzerdefinierten Eigenschaft ein Komma enthält, muss diesem ein Escapezeichen ('\') vorangestellt werden.

Weitere Informationen zu jeder benutzerdefinierten Eigenschaft, einschließlich Beispielen, finden Sie unter Liste der benutzerdefinierten Eigenschaften.

Zugreifen auf benutzerdefinierte Eigenschaften

Benutzerdefinierte Eigenschaften werden im Eigenschaftenfenster von Visual Studio nicht angezeigt. Um im Programm auf diese zuzugreifen, müssen Sie die CustomProperties-Eigenschaft nicht angeben. Fügen Sie dem Series-Objekt oder dem DataPoint-Objekt einfach einen Indexer hinzu, und verwenden Sie den Namen der benutzerdefinierten Eigenschaft als Index, um das jeweilige Name-Wert-Paar abzurufen und festzulegen. Mit dieser Methode können Sie nur auf diese bestimmte benutzerdefinierte Eigenschaft zugreifen.

Das Series-Objekt und das DataPoint-Objekt stellen weitere Methoden für den Zugriff auf benutzerdefinierte Eigenschaften bereit. Beispiel: IsCustomPropertySet, SetCustomProperty, SetCustomProperty und DeleteCustomProperty.

Der folgende Code greift auf die benutzerdefinierte Eigenschaft Exploded im DataPoint-Objekt eines Kreisdiagramms zu, legt diese auf True fest und überprüft dann ihren Wert:

' Explode the first pie slice
Chart1.Series("Default").Points(0)("Exploded") = "True"
…
' Check if the the first pie slice is still exploded
If Chart1.Series("Default").Points(0)("Exploded") = "True"
    ' Do something
End If
// Explode the first pie slice
Chart1.Series["Default"].Points[0]["Exploded"] = "True"
…
// Check if the the first pie slice is still exploded
if (Chart1.Series["Default"].Points[0]["Exploded"] == "True")
{
    //Do something
}

Siehe auch

Referenz

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Konzepte

Liste der benutzerdefinierten Eigenschaften