SPFieldCollection.Item property (Int32)

發行項
05/05/2015

取得集合中指定之索引處的欄位物件。在 Microsoft C#，這個屬性會是SPFieldCollection類別的索引子。

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
Public ReadOnly Default Property Item ( _
    iIndex As Integer _
) As SPField
    Get
'用途
Dim instance As SPFieldCollection
Dim iIndex As Integer
Dim value As SPField

value = instance(iIndex)

public SPField this[
    int iIndex
] { get; }

參數

iIndex
Type: System.Int32

32 位元的整數，指定欄位的索引。

Property value

Type: Microsoft.SharePoint.SPField
SPField 物件，表示該欄位。

備註

如果指定的索引超出索引集合的有效範圍內的 [ Item ] 屬性，則會擲回ArgumentOutOfRangeException 。

Examples

下列程式碼範例會逐一查看清單的欄位集合，並顯示標題和每個欄位的型別。

這個範例要求using指示詞 (Imports Microsoft Visual Basic 中)， Microsoft.SharePoint和Microsoft.SharePoint.Utilities命名空間。

此範例假設包含一個標籤控制項的.aspx 網頁的存在。

Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MySite")
Try
    Dim fields As SPFieldCollection = webSite.Lists("MyList").Fields
    Dim i As Integer

    For i = 0 To fields.Count - 1
        Label1.Text += SPEncode.HtmlEncode(fields(i).Title) + " :: " + fields(i).TypeAsString + "<BR>"
    Next i
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["MySite"])
{
    SPFieldCollection collFields = oWebsite.Lists["MyList"].Fields;

    for (int intIndex=0; intIndex<collFields.Count; intIndex++)
    {
        Label1.Text += SPEncode.HtmlEncode(collFields[intIndex].Title) + " :: " + collFields[intIndex].TypeAsString + "<BR>";
     }
}

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。