Clase SPFieldCollection
Representa una colección de objetos SPField .
Jerarquía de la herencia
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.SPBaseCollection
Microsoft.SharePoint.SPFieldCollection
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public Class SPFieldCollection _
Inherits SPBaseCollection
'Uso
Dim instance As SPFieldCollection
public class SPFieldCollection : SPBaseCollection
Comentarios
Utilice la propiedad Fields de la clase SPList o la clase SPListItem para devolver la colección de campos de una lista o elemento de lista. Utilice la propiedad Fields de la clase SPWeb para devolver los campos en el sitio Web y use la propiedad Fields de la clase SPContentType para obtener los campos que están asociados con el tipo de contenido. Para crear un campo, use el método Add .
Utilice un indizador para devolver un solo campo de la colección. Por ejemplo, suponiendo que la colección se ha asignado a una variable denominada collFields, use collFields[index] en C# o collFields(index) en Visual Basic, donde index es el número de índice del campo en la colección o el nombre para mostrar del campo.
Ejemplos
En el ejemplo de código siguiente se agrega un nuevo campo de texto a la lista de anuncios de un sitio Web especificado que se muestra en la vista predeterminada de la 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();
}
Nota
Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.