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 Speicher-Datenpunkte und -Reihenattribute 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.
Ein Series speichert DataPoint -Objekte mithilfe der DataPointCollection -Klasse. Außerdem werden Attribute der Datenreihe gespeichert. Eine Datenreihe verfügt beispielsweise über ein Farbattribut, ein Hintergrundbildattribut, ein Hintergrundfarbverlaufsattribut usw.
Die DataPoint Objekte, die zu einer Reihe gehören, verfügen ebenfalls über eigene Attribute. Wenn das gleiche Attribut für einen Datenpunkt und die Reihe, zu der es gehört, festgelegt ist, hat das Datenpunktattribut normalerweise Vorrang.
Eine Reihe wird nicht unbedingt in einem Diagramm gezeichnet. Sie kann Datenpunktwerte speichern, die zum Ausführen einer Berechnung verwendet werden, aus der eine andere Reihe erstellt und dann gezeichnet wird. Beispielsweise kann die gezeichnete Serie A das Ergebnis des Hinzufügens von Datenpunkten der Serie B und Serie C sein, obwohl keine dieser Reihen gezeichnet wird. Um ein -Objekt zu Series zeichnen, muss die ChartArea -Eigenschaft auf den Namen des Objekts festgelegt werden, das ChartArea zum Zeichnen der Reihe verwendet wird.
Wenn eine Reihe erstellt wird, wird sie automatisch dem ChartArea Objekt mit dem Namen "Default" oder der ersten verfügbaren Diagrammfläche in der Diagrammbereichsauflistung zugewiesen, wenn das Default-Objekt nicht vorhanden ist.
Um die Anzeige einer Reihe zu deaktivieren, legen Sie die -Eigenschaft auf eine Zeichenfolge der ChartArea Länge 0 fest.
Die ChartType -Eigenschaft bestimmt den Typ des Diagramms, das zum Zeichnen dieser Reihe verwendet wird, wenn sie gezeichnet wird.
Konstruktoren
| Series() |
Initialisiert eine neue Instanz der Series-Klasse. |
| Series(String) |
Initialisiert eine neue Instanz der Series-Klasse mit dem angegebenen Reihennamen. |
| Series(String, Int32) |
Initialisiert eine neue Instanz der Series-Klasse mit dem angegebenen Namen und der angegebenen maximalen Anzahl von y-Werten. |
Eigenschaften
| AxisLabel |
Ruft den Achsenbezeichnungstext für die Reihe ab oder legt diesen fest. |
| BackGradientStyle |
Ruft die Art des Hintergrundfarbverlaufs ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackHatchStyle |
Ruft die Schraffurart des Hintergrunds ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackImage |
Ruft das Hintergrundbild des Datenpunkts ab oder legt dieses fest. (Geerbt von DataPointCustomProperties) |
| BackImageAlignment |
Ruft die Ausrichtung des Hintergrundbilds ab, die mit dem Unscaled-Zeichnungsmodus verwendet wird, oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackImageTransparentColor |
Ruft eine Farbe ab, die beim Zeichnen des Hintergrundbilds durch eine transparente Farbe ersetzt wird, oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BackImageWrapMode |
Ruft den Zeichnungsmodus des Hintergrundbilds ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| BackSecondaryColor |
Ruft die sekundäre Hintergrundfarbe ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BorderColor |
Ruft die Rahmenfarbe des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BorderDashStyle |
Ruft die Rahmenart des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| BorderWidth |
Ruft die Rahmenbreite des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| ChartArea |
Ruft ggf. den Namen des zum Zeichnen der Datenreihe verwendeten ChartArea-Objekts ab oder legt diesen fest. |
| ChartType |
Ruft den Diagrammtyp einer Reihe ab oder legt diesen fest. |
| ChartTypeName |
Ruft den Namen des zum Zeichnen der Reihe verwendeten Diagrammtyps ab oder legt diesen fest. |
| Color |
Ruft die Farbe des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| CustomProperties |
Ruft die benutzerdefinierten Eigenschaften des Datenpunkts ab oder legt diese fest. Benutzerdefinierte Eigenschaften können im folgenden Format angegeben werden: AttrName1=Value1, AttrName2=Value2 … (Geerbt von DataPointCustomProperties) |
| CustomPropertiesExtended |
Ruft die erweiterten benutzerdefinierten Eigenschaften des Datenpunkts ab oder legt diese fest. Erweiterte benutzerdefinierte Eigenschaften können im folgenden Format angegeben werden: AttrName1=Wert1, AttrName2=Wert2, … (Geerbt von DataPointCustomProperties) |
| EmptyPointStyle |
Ruft den Zeichnungsstil von Punkten ab, die als leer markiert sind, oder legt diesen fest. |
| Enabled |
Ruft ein Flag ab, das angibt, ob die Reihe im gerenderten Diagramm sichtbar ist, oder legt dieses fest. |
| Font |
Ruft die Schriftart des Datenpunkts ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| IsValueShownAsLabel |
Ruft ein Flag ab, das angibt, ob der Wert des Datenpunkts in der Bezeichnung angezeigt werden soll, oder legt dieses fest. (Geerbt von DataPointCustomProperties) |
| IsVisibleInLegend |
Ruft ein Flag ab, das angibt, ob das Element in der Legende angezeigt wird, oder legt dieses fest. (Geerbt von DataPointCustomProperties) |
| IsXValueIndexed |
Ruft ein Flag ab, das angibt, ob als x-Werte Datenpunktindizes verwendet werden, oder legt dieses fest. |
| Item[Int32] |
Ruft das DataPointCustomProperties-Objekt nach seiner Position im Index ab. (Geerbt von DataPointCustomProperties) |
| Item[String] |
Ruft das DataPointCustomProperties-Objekt anhand des Namens ab oder legt dieses 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 diese fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderColor |
Ruft die Rahmenfarbe der Datenpunktbezeichnung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderDashStyle |
Ruft die Rahmenart der Bezeichnung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| LabelBorderWidth |
Ruft die Rahmenbreite der Bezeichnung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| LabelForeColor |
Ruft die Textfarbe der Bezeichnung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| LabelFormat |
Ruft das Format der Datenpunktbezeichnung ab oder legt dieses fest. (Geerbt von DataPointCustomProperties) |
| LabelToolTip |
Ruft die QuickInfo für die Datenpunktbezeichnung ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| Legend |
Ruft den Namen der dem Legend-Objekt zugeordneten Reihe ab oder legt diesen fest. |
| LegendText |
Ruft den Text des Elements in der Legende ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| LegendToolTip |
Ruft die QuickInfo des Elements in der Legende ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerBorderColor |
Ruft die Rahmenfarbe des Markers ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerBorderWidth |
Ruft die Rahmenbreite des Markers ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerColor |
Ruft die Markerfarbe ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerImage |
Ruft das Markerbild ab oder legt dieses fest. (Geerbt von DataPointCustomProperties) |
| MarkerImageTransparentColor |
Ruft die Farbe ab, die beim Zeichnen des Markerbilds durch eine transparente Farbe ersetzt wird, oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerSize |
Ruft die Größe des Markers ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| MarkerStep |
Ruft einen Wert ab, der bestimmt, mit welcher Häufigkeit Datenpunktmarker angezeigt werden sollen, oder legt diesen fest. |
| MarkerStyle |
Ruft den Markierungsstil ab oder legt diesen fest. (Geerbt von DataPointCustomProperties) |
| Name |
Ruft den eindeutigen Namen eines Series-Objekts ab oder legt diesen fest. |
| Palette |
Ruft die Farbpalette eines Series-Objekts ab oder legt diese fest. |
| Points |
Ruft eine Auflistung von Datenpunkten ab. |
| ShadowColor |
Ruft die Schattenfarbe einer Reihe ab oder legt diese fest. |
| ShadowOffset |
Ruft den Schattenoffset in Pixel einer Reihe ab oder legt diesen fest. |
| SmartLabelStyle |
Ruft den Stil der intelligenten Bezeichnungen ab oder legt diesen fest. |
| Tag |
Ruft ein Objekt ab, das dem Diagrammelement zugeordnet ist, oder legt dieses fest. (Geerbt von ChartElement) |
| ToolTip |
Ruft die QuickInfo ab oder legt diese fest. (Geerbt von DataPointCustomProperties) |
| XAxisType |
Ruft den x-Achsentyp der Reihe ab oder legt diesen fest. |
| XValueMember |
Ruft den Member der Diagrammdatenquelle ab, die für die Datenbindung an den x-Wert der Reihe verwendet wird, oder legt diese fest. |
| XValueType |
Ruft die auf der x-Achse gezeichneten Werttypen ab oder legt diese fest. |
| YAxisType |
Ruft den y-Achsentyp einer Reihe ab oder legt diesen fest. |
| YValueMembers |
Ruft die Memberspalten der Diagrammdatenquelle ab, die zum Binden von Daten an die y-Werte der Reihe verwendet werden, oder legt diese fest. |
| YValuesPerPoint |
Ruft die maximale Anzahl von y-Werten ab, die für DataPoint-Objekte in einer Series zulässig sind, oder legt diese fest. |
| YValueType |
Ruft den Typ der y-Wertdaten in den in einer Reihe gespeicherten Datenpunkten ab oder legt diesen fest. |
Methoden
| DeleteCustomProperty(String) |
Löscht die benutzerdefinierte Datenpunkteigenschaft mit dem angegebenen Namen. (Geerbt von DataPointCustomProperties) |
| Dispose() |
Gibt die von der ChartElement verwendeten Ressourcen frei. (Geerbt von ChartElement) |
| Dispose(Boolean) |
Gibt die von Series verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. |
| Equals(Object) |
Bestimmt, ob das angegebene Object und das aktuelle ChartElement gleich sind. (Geerbt von ChartElement) |
| GetCustomProperty(String) |
Gibt die benutzerdefinierte Datenpunkteigenschaft 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 den 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 des 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 Reihe mithilfe der IComparer-Schnittstelle. |
| Sort(PointSortOrder) |
Sortiert die Datenpunkte in der Reihe mit der angegebenen Sortierreihenfolge. |
| Sort(PointSortOrder, String) |
Sortiert die Punkte in der Reihe mit der angegebenen Sortierreihenfolge und dem angegebenen Wert, der für die Sortierung verwendet werden soll. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Object-Objekt darstellt. (Geerbt von ChartElement) |