GetEffectiveValue

ListLevel.GetEffectiveValue method

Gibt die String-Darstellung desListLevelObjekt für den angegebenen Index des Listenelements. Parameter geben dieNumberStyle und ein optionaler Formatstring , der verwendet wird, wennCustom ist angegeben.

public static string GetEffectiveValue(int index, NumberStyle numberStyle, 
    string customNumberStyleFormat)
ParameterTypBeschreibung
indexInt32Der Index des Listenelements (muss im Bereich von 1 bis 32767 liegen).
numberStyleNumberStyleDieNumberStyle derListLevel Objekt.
customNumberStyleFormatStringDie optionale Formatzeichenfolge, die verwendet wird, wennCustom angegeben ist (zB “a, ç, ĝ, …”). In anderen Fällen muss dieser Parameternull oder leer.

Rückgabewert

Die String-Darstellung desListLevel Objekt, beschrieben durch dienumberStyle Parameter und dercustomNumberStyleFormat Parameter, im Listenelement an der Position, die durch denindex parameter.

Ausnahmen

AusnahmeBedingung
ArgumentExceptioncustomNumberStyleFormat Istnull oder leer, wenn dienumberStyle ist benutzerdefiniert.-oder- customNumberStyleFormat ist nichtnull oder leer, wenn dienumberStyle ist nicht benutzerdefiniert.-oder- customNumberStyleFormat ist ungültig.
ArgumentOutOfRangeExceptionIndex liegt außerhalb des Bereichs.

Beispiele

Zeigt, wie Sie das Format für eine Liste mit dem benutzerdefinierten Zahlenstil erhalten.

Document doc = new Document(MyDir + "List with leading zero.docx");

ListLevel listLevel = doc.FirstSection.Body.Paragraphs[0].ListFormat.ListLevel;

string customNumberStyleFormat = string.Empty;

if (listLevel.NumberStyle == NumberStyle.Custom)
    customNumberStyleFormat = listLevel.CustomNumberStyleFormat;

Assert.AreEqual("001, 002, 003, ...", customNumberStyleFormat);

// Wir können den Wert für den angegebenen Index des Listenelements abrufen.
Assert.AreEqual("iv", ListLevel.GetEffectiveValue(4, NumberStyle.LowercaseRoman, null));
Assert.AreEqual("005", ListLevel.GetEffectiveValue(5, NumberStyle.Custom, customNumberStyleFormat));

Siehe auch