SPFieldCollection class

發行項
05/05/2015

表示SPField物件的集合。

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.SPBaseCollection
      Microsoft.SharePoint.SPFieldCollection

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

Syntax

'宣告
Public Class SPFieldCollection _
    Inherits SPBaseCollection
'用途
Dim instance As SPFieldCollection

public class SPFieldCollection : SPBaseCollection

備註

SPList類別或SPListItem類別的Fields屬性可以用於傳回欄位的清單或清單項目集合。使用SPWeb類別的Fields屬性來傳回欄位中的網站，和使用SPContentType類別的Fields屬性來取得內容型別相關聯的欄位。若要建立欄位，請使用Add方法。

若要從集合傳回單一欄位中使用索引子。例如，假設集合已被指派到名為collFields的變數，請使用在 C# 的collFields[index]或 Visual Basic，其中index是集合中的欄位索引編號，或者是欄位的顯示名稱中的collFields(index) 。

Examples

下列程式碼範例會將新的 [文字] 欄位加入至指定的網站顯示清單的預設檢視中的 [宣布] 清單。

Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MySite")
Try
    Dim list As SPList = webSite.GetList("Lists/Announcements/AllItems.aspx")
    Dim fields As SPFieldCollection = list.Fields

    Dim newFieldName As String = fields.Add("MyNewField", SPFieldType.Text, False)

    Dim fieldAdd As SPField = fields.GetField(newFieldName)

    Dim view As SPView = list.DefaultView
    Dim viewFields As SPViewFieldCollection = view.ViewFields
    viewFields.Add(fieldAdd)
    view.Update()
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["MySite"])
{
    SPList oList = oWebsite.GetList("Lists/Announcements/AllItems.aspx");
    SPFieldCollection collFields = oList.Fields;

    string strNewFieldName = collFields.Add("MyNewField", SPFieldType.Text, false);
    SPField oField = collFields.GetField(strNewFieldName);

    SPView oView = oList.DefaultView;
    SPViewFieldCollection collViewFields = oView.ViewFields;
    collViewFields.Add(oField);
    oView.Update();
}

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