Series Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die zu speichernden Datenpunkte und Datenreihenattribute dar.
public ref class Series : System::Windows::Forms::DataVisualization::Charting::DataPointCustomPropertiespublic class Series : System.Windows.Forms.DataVisualization.Charting.DataPointCustomPropertiestype Series = class
inherit DataPointCustomPropertiesPublic Class Series
Inherits DataPointCustomProperties- Vererbung
Hinweise
Ein Series Objekt stellt eine Datenreihe dar und wird in der SeriesCollection Klasse gespeichert.
A Series stores DataPoint objects using the DataPointCollection class. Außerdem werden Attribute der Datenreihe gespeichert. Beispielsweise verfügt eine Datenreihe über ein Farbattribute, ein Hintergrundbild-Attribut, ein Hintergrundfarbverlaufsattribut usw.
Die DataPoint Objekte, die zu einer Datenreihe gehören, weisen auch eigene Attribute auf. Wenn dasselbe Attribut für einen Datenpunkt und die Datenreihe, zu der es gehört, festgelegt wird, hat das Datenpunkt-Attribut Vorrang.
Eine Datenreihe wird nicht unbedingt in einem Diagramm gezeichnet; Sie kann Datenpunktwerte speichern, die zum Ausführen einer Berechnung verwendet werden, aus der eine andere Datenreihe erstellt und dann gezeichnet wird. Beispielsweise kann die Datenreihe A, die gezeichnet wird, das Ergebnis des Hinzufügens von Datenpunkten von Series B und Series C sein, obwohl keine dieser Datenreihen gezeichnet wird. Um ein Series Objekt zu zeichnen, muss die ChartArea Eigenschaft auf den Namen des ChartArea Objekts festgelegt werden, das zum Zeichnen der Datenreihe verwendet wird.
Wenn eine Datenreihe erstellt wird, wird sie dem Objekt mit dem ChartArea Namen "Default" oder dem ersten verfügbaren Diagrammbereich in der Diagrammbereichssammlung automatisch zugewiesen, wenn das "Default"-Objekt nicht vorhanden ist.
Um die Anzeige einer Datenreihe zu deaktivieren, legen Sie die ChartArea Eigenschaft auf eine leere Zeichenfolge fest.
Die ChartType Eigenschaft bestimmt den Typ des Diagramms, das zum Zeichnen dieser Datenreihe verwendet wird.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Series() |
Initialisiert eine neue Instanz der Series-Klasse. |
| Series(String, Int32) |
Initialisiert eine neue Instanz der Series Klasse mit dem angegebenen Namen und der maximalen Anzahl von Y-Werten. |
| Series(String) |
Initialisiert eine neue Instanz der Series Klasse mit dem angegebenen Reihennamen. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AxisLabel |
Dient zum Abrufen oder Festlegen des Achsenbezeichnungstexts für die Datenreihe. |
| BackGradientStyle |
Dient zum Abrufen oder Festlegen des Hintergrundverlaufsstils. (Geerbt von DataPointCustomProperties) |
| BackHatchStyle |
Ruft die Formatvorlage für das Schlupfen im Hintergrund ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackImage |
Ruft das Hintergrundbild des Datenpunkts ab oder legt es fest. (Geerbt von DataPointCustomProperties) |
| BackImageAlignment |
Ruft die Ausrichtung des Hintergrundbilds ab, das mit dem Unscaled Zeichnungsmodus verwendet wird, oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackImageTransparentColor |
Dient zum Abrufen oder Festlegen einer Farbe, die durch eine transparente Farbe ersetzt wird, wenn das Hintergrundbild gezeichnet wird. (Geerbt von DataPointCustomProperties) |
| BackImageWrapMode |
Dient zum Abrufen oder Festlegen des Zeichnungsmodus des Hintergrundbilds. (Geerbt von DataPointCustomProperties) |
| BackSecondaryColor |
Ruft die sekundäre Hintergrundfarbe ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| BorderColor |
Abruf oder Festlegung der Randfarbe des Datenpunkts. (Geerbt von DataPointCustomProperties) |
| BorderDashStyle |
Ruft die Rahmenart des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BorderWidth |
Abruf oder Festlegung der Randbreite des Datenpunkts. (Geerbt von DataPointCustomProperties) |
| ChartArea |
Ruft den Namen des Objekts ab, das ChartArea zum Zeichnen der Datenreihe verwendet wird, falls vorhanden. |
| ChartType |
Dient zum Abrufen oder Festlegen des Diagrammtyps einer Datenreihe. |
| ChartTypeName |
Ruft den Namen des Diagrammtyps ab, der zum Zeichnen der Datenreihe verwendet wird, oder legt diesen fest. |
| Color |
Abruf oder Festlegung der Farbe des Datenpunkts. (Geerbt von DataPointCustomProperties) |
| CustomProperties |
Dient zum Abrufen oder Festlegen der benutzerdefinierten Eigenschaften des Datenpunkts. Benutzerdefinierte Eigenschaften können im folgenden Format angegeben werden: AttrName1=Value1, AttrName2=Value2 ... (Geerbt von DataPointCustomProperties) |
| CustomPropertiesExtended |
Dient zum Abrufen oder Festlegen der erweiterten benutzerdefinierten Eigenschaften des Datenpunkts. Erweiterte benutzerdefinierte Eigenschaften können im folgenden Format angegeben werden: AttrName1=Value1, AttrName2=Value2... (Geerbt von DataPointCustomProperties) |
| EmptyPointStyle |
Dient zum Abrufen oder Festlegen des Zeichnungsstils von Punkten, die als leer markiert sind. |
| Enabled |
Dient zum Abrufen oder Festlegen eines Flags, das angibt, ob die Datenreihe im gerenderten Diagramm sichtbar ist. |
| Font |
Ruft die Schriftart des Datenpunkts ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| IsValueShownAsLabel |
Ruft ein Flag ab oder legt es fest, das angibt, ob der Wert des Datenpunkts auf der Beschriftung angezeigt werden soll. (Geerbt von DataPointCustomProperties) |
| IsVisibleInLegend |
Ruft ein Flag ab oder legt es fest, das angibt, ob das Element in der Legende angezeigt wird. (Geerbt von DataPointCustomProperties) |
| IsXValueIndexed |
Dient zum Abrufen oder Festlegen eines Flags, das angibt, ob Datenpunktindizes für die X-Werte verwendet werden. |
| Item[Int32] |
Ruft das DataPointCustomProperties Objekt anhand seiner Position im Index ab. (Geerbt von DataPointCustomProperties) |
| Item[String] |
Ruft das Objekt anhand des Namens ab oder legt es DataPointCustomProperties fest. (Geerbt von DataPointCustomProperties) |
| Label |
Ruft den Text der Datenpunktbezeichnung ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| LabelAngle |
Ruft den Winkel der Datenpunktbezeichnung ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| LabelBackColor |
Ruft die Hintergrundfarbe der Datenpunktbezeichnung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderColor |
Ruft die Rahmenfarbe der Datenpunktbezeichnung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderDashStyle |
Ruft die Rahmenart der Beschriftung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderWidth |
Ruft die Rahmenbreite der Beschriftung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| LabelForeColor |
Abruf oder Festlegung der Textfarbe der Beschriftung. (Geerbt von DataPointCustomProperties) |
| LabelFormat |
Abruf oder Festlegung des Formats der Datenpunktbeschriftung. (Geerbt von DataPointCustomProperties) |
| LabelToolTip |
Dient zum Abrufen oder Festlegen der QuickInfo für die Datenpunktbezeichnung. (Geerbt von DataPointCustomProperties) |
| Legend |
Dient zum Abrufen oder Festlegen des Namens der Datenreihe, die dem Legend Objekt zugeordnet ist. |
| LegendText |
Ruft den Text des Elements in der Legende ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| LegendToolTip |
Dient zum Abrufen oder Festlegen der QuickInfo des Elements in der Legende. (Geerbt von DataPointCustomProperties) |
| MarkerBorderColor |
Ruft die Rahmenfarbe der Markierung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| MarkerBorderWidth |
Ruft die Rahmenbreite der Markierung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| MarkerColor |
Ruft die Markierungsfarbe ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| MarkerImage |
Ruft das Markierungsbild ab oder legt es fest. (Geerbt von DataPointCustomProperties) |
| MarkerImageTransparentColor |
Ruft die Farbe ab, die beim Zeichnen des Markierungsbilds durch eine transparente Farbe ersetzt wird, oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| MarkerSize |
Ruft die Größe der Markierung ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| MarkerStep |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, wie oft Datenpunktmarkierungen angezeigt werden. |
| MarkerStyle |
Ruft die Markierungsformatvorlage ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| Name |
Dient zum Abrufen oder Festlegen des eindeutigen Namens eines Series Objekts. |
| Palette |
Dient zum Abrufen oder Festlegen der Farbpalette eines Series Objekts. |
| Points |
Ruft eine Sammlung von Datenpunkten ab. |
| ShadowColor |
Ruft die Schattenfarbe einer Datenreihe ab oder legt sie fest. |
| ShadowOffset |
Dient zum Abrufen oder Festlegen des Schattenoffsets in Pixeln einer Datenreihe. |
| SmartLabelStyle |
Ruft die Formatvorlage der Smart labels ab oder legt diese fest. |
| Tag |
Dient zum Abrufen oder Festlegen eines Objekts, das diesem Diagrammelement zugeordnet ist. (Geerbt von ChartElement) |
| ToolTip |
Ruft die QuickInfo ab oder legt sie fest. (Geerbt von DataPointCustomProperties) |
| XAxisType |
Ruft den X-Achsentyp der Serie ab oder legt diesen fest. |
| XValueMember |
Ruft das Element der Diagrammdatenquelle ab, das zum Binden an den X-Wert der Datenreihe verwendet wird, oder legt dieses fest. |
| XValueType |
Dient zum Abrufen oder Festlegen der Werttypen, die entlang der X-Achse gezeichnet werden. |
| YAxisType |
Ruft den Y-Achsentyp einer Serie ab oder legt diesen fest. |
| YValueMembers |
Dient zum Abrufen oder Festlegen von Memberspalten der Diagrammdatenquelle, die zum Binden von Daten an die Y-Werte der Datenreihe verwendet wird. |
| YValuesPerPoint |
Dient zum Abrufen oder Festlegen der maximalen Anzahl von Y-Werten, über die DataPoint Objekte in einem Series Objekt verfügen dürfen. |
| YValueType |
Dient zum Abrufen oder Festlegen des Typs von Y-Wertdaten in den Datenpunkten, die von einer Datenreihe gespeichert sind. |
Methoden
| Name | Beschreibung |
|---|---|
| DeleteCustomProperty(String) |
Löscht die benutzerdefinierte Eigenschaft des Datenpunkts mit dem angegebenen Namen. (Geerbt von DataPointCustomProperties) |
| Dispose() |
Gibt die von der ChartElement. (Geerbt von ChartElement) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den Series verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. |
| Equals(Object) |
Bestimmt, ob der angegebene Object Wert gleich dem aktuellen ChartElementist. (Geerbt von ChartElement) |
| GetCustomProperty(String) |
Gibt die benutzerdefinierte Eigenschaft des Datenpunkts mit dem angegebenen Namen zurück. (Geerbt von DataPointCustomProperties) |
| GetHashCode() |
Gibt eine Hashfunktion für einen bestimmten Typ zurück. (Geerbt von ChartElement) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsCustomPropertySet(String) |
Bestimmt, ob eine benutzerdefinierte Eigenschaft mit dem angegebenen Namen festgelegt wurde. (Geerbt von DataPointCustomProperties) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ResetIsValueShownAsLabel() |
Setzt eine benutzerdefinierte Eigenschaft auf den Standardwert zurück. (Geerbt von DataPointCustomProperties) |
| ResetIsVisibleInLegend() |
Setzt eine benutzerdefinierte Eigenschaft auf den Standardwert zurück. (Geerbt von DataPointCustomProperties) |
| SetCustomProperty(String, String) |
Legt eine benutzerdefinierte Eigenschaft des Datenpunkts fest. (Geerbt von DataPointCustomProperties) |
| SetDefault(Boolean) |
Legt die Standardeigenschaften des Datenpunkts fest. Gibt an, ob die vorherigen Eigenschaftswerte gelöscht werden müssen. (Geerbt von DataPointCustomProperties) |
| Sort(IComparer<DataPoint>) |
Sortiert die Punkte in der Datenreihe mithilfe IComparer der Schnittstelle. |
| Sort(PointSortOrder, String) |
Sortiert die Punkte in der Datenreihe, wobei die angegebene Sortierreihenfolge und der für die Sortierung zu verwendende Wert angegeben sind. |
| Sort(PointSortOrder) |
Sortiert die Datenpunkte in der Datenreihe, je nach der angegebenen Sortierreihenfolge. |
| ToString() |
Gibt eine Zeichenfolge zurück, die die aktuelle Objectdarstellt. (Geerbt von ChartElement) |
