Compartilhar via


SPFieldCollection class

Representa uma coleção de objetos 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

'Declaração
Public Class SPFieldCollection _
    Inherits SPBaseCollection
'Uso
Dim instance As SPFieldCollection
public class SPFieldCollection : SPBaseCollection

Comentários

Use a propriedade Fields da classe SPList ou a classe SPListItem para retornar a coleção de campos de uma lista ou item da lista. Use a propriedade Fields da classe SPWeb para retornar os campos no site e use a propriedade Fields da classe SPContentType para obter os campos que estão associados com o tipo de conteúdo. Para criar um campo, use o método Add .

Use um indexador para retornar um único campo da coleção. Por exemplo, supondo que a coleção foi atribuída a uma variável chamada collFields, use collFields[index] em C# ou deindexde collFields() no Visual Basic, onde index é o número de índice do campo na coleção ou o nome de exibição do campo.

Examples

O exemplo de código a seguir adiciona um novo campo de texto para a lista de anúncios de um site da Web especificado que é exibido no modo de exibição padrão da lista.

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();
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Thread safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Ver também

Referência

SPFieldCollection members

Microsoft.SharePoint namespace