SPFieldCollection.Add method (String, SPFieldType, Boolean)
Cria um campo na coleção com base no nome para exibição especificado, tipo de campo e valor booleano.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
Public Function Add ( _
strDisplayName As String, _
type As SPFieldType, _
bRequired As Boolean _
) As String
'Uso
Dim instance As SPFieldCollection
Dim strDisplayName As String
Dim type As SPFieldType
Dim bRequired As Boolean
Dim returnValue As String
returnValue = instance.Add(strDisplayName, _
type, bRequired)
public string Add(
string strDisplayName,
SPFieldType type,
bool bRequired
)
Parâmetros
strDisplayName
Type: System.StringUma seqüência de caracteres que especifica o nome de exibição do campo.
type
Type: Microsoft.SharePoint.SPFieldTypeUm valor de SPFieldType que especifica o tipo de campo para criar.
bRequired
Type: System.Booleantrue se o campo deve conter um valor; Caso contrário, false.
Valor retornado
Type: System.String
Uma seqüência de caracteres que contém o nome do novo campo interno.
Comentários
O método Add não pode ser usado para criar um campo de tipo Lookup, porque isso faz com que um SPException ser lançada. Em vez disso, use o método AddLookup para adicionar um campo desse tipo.
Examples
O exemplo de código a seguir adiciona um campo de texto obrigatório à lista especificada.
Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MySite")
Try
Dim fields As SPFieldCollection = webSite.Lists("MyList").Fields
fields.Add("MyField", Microsoft.SharePoint.SPFieldType.Text, True)
Finally
webSite.Dispose()
End Try
using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["MySite"])
{
SPFieldCollection collFields = oWebsite.Lists["MyList"].Fields;
collFields.Add("MyField", Microsoft.SharePoint.SPFieldType.Text,
true);
}
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.