LoadOptions 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定剖析 XML 時的載入選項。
此列舉支援其成員值的位元組合。
public enum class LoadOptions[System.Flags]
public enum LoadOptions[<System.Flags>]
type LoadOptions = Public Enum LoadOptions- 繼承
- 屬性
欄位
| None | 0 | 請勿保留不重要的泛空白字元，或載入基底 URI 和行資訊。 |
| PreserveWhitespace | 1 | 在剖析時保留不重要的泛空白字元。 |
| SetBaseUri | 2 | |
| SetLineInfo | 4 |
範例
本範例會從檔案載入小型 XML 樹狀結構，設定選項以設定基底 URI 並保留行資訊。 然後，它會新增另一個沒有行資訊的專案。 然後，它會列印樹狀結構中每個專案的行資訊。
string markup = @"<Root>
<Child1 />
<Child2 />
<Child4 />
</Root>";
File.WriteAllText("Test.xml", markup);
XElement po = XElement.Load("Test.xml",
LoadOptions.SetBaseUri | LoadOptions.SetLineInfo);
// add a node to the tree.
// the newly added node will not have line information.
po.Element("Child2").AddAfterSelf(new XElement("Child3"));
string[] splitUri = po.BaseUri.Split('/');
Console.WriteLine("BaseUri: {0}", splitUri[splitUri.Length - 1]);
Console.WriteLine();
Console.WriteLine("{0}{1}{2}",
"Element Name".PadRight(20),
"Line".PadRight(5),
"Position");
Console.WriteLine("{0}{1}{2}",
"------------".PadRight(20),
"----".PadRight(5),
"--------");
foreach (XElement e in po.DescendantsAndSelf())
Console.WriteLine("{0}{1}{2}",
("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),
((IXmlLineInfo)e).HasLineInfo() ?
((IXmlLineInfo)e).LineNumber.ToString().PadRight(5) :
"",
((IXmlLineInfo)e).HasLineInfo() ?
((IXmlLineInfo)e).LinePosition.ToString() :
"No Line Information");
Dim markup As String = _
"<Root>" + Environment.NewLine & _
" <Child1 />" + Environment.NewLine & _
" <Child2 />" + Environment.NewLine & _
" <Child4 />" + Environment.NewLine & _
"</Root>"
File.WriteAllText("Test.xml", markup)
Dim po As XElement = XElement.Load("Test.xml", LoadOptions.SetBaseUri Or LoadOptions.SetLineInfo)
' add a node to the tree.
' the newly added node will not have line information.
po.Element("Child2").AddAfterSelf(New XElement("Child3"))
Dim splitUri() As String = po.BaseUri.Split("/"c)
Console.WriteLine("BaseUri: {0}", splitUri(splitUri.Length - 1))
Console.WriteLine()
Console.WriteLine("{0}{1}{2}", _
"Element Name".PadRight(20), _
"Line".PadRight(5), _
"Position")
Console.WriteLine("{0}{1}{2}", _
"------------".PadRight(20), _
"----".PadRight(5), _
"--------")
For Each e As XElement In po.DescendantsAndSelf()
Console.WriteLine("{0}{1}{2}", _
("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString).PadRight(20), _
IIf(DirectCast(e, IXmlLineInfo).HasLineInfo(), _
DirectCast(e, IXmlLineInfo).LineNumber.ToString().PadRight(5), _
""), _
IIf(DirectCast(e, IXmlLineInfo).HasLineInfo(), _
DirectCast(e, IXmlLineInfo).LinePosition.ToString(), _
"No Line Information"))
Next
這個範例會產生下列輸出：
BaseUri: Test.xml
Element Name Line Position
------------ ---- --------
Root 1 2
Child1 2 6
Child2 3 6
Child3 No Line Information
Child4 4 6
備註
如果您在載入時保留空白字元，XML 樹狀結構中的所有無意義的空白字元會依原樣具體化在 XML 樹狀結構中。 如果您未保留空白字元，則會捨棄所有不重要的空白字元。
如果您設定 SetBaseUri 和 SetLineInfo 旗標，則效能會降低。
載入 XML 檔之後，基底 URI 和行資訊會立即正確。 如果您在載入檔之後修改 XML 樹狀結構，基底 URI 和行資訊可能會變成無意義。
如果基礎 XmlReader 沒有基底 URI 或行資訊，則設定 SetBaseUri 和 SetLineInfo 旗標將不會有任何作用。
此類型可讓您控制載入或剖析時LINQ to XML如何處理空白字元。 如需詳細資訊，請參閱 在載入或剖析 XML 時保留空白字元 ，以及在 序列化時保留空白字元。