GetFieldMaxLength

Descrizione

Restituisce la lunghezza massima del campo specificata al momento della creazione del campo utilizzando Rational ClearQuest Designer. Questo valore corrisponde al numero di byte consentiti nella colonna. Il numero effettivo di caratteri consentiti dipende dalla codifica del database (ovvero, la serie di caratteri e la codifica della serie di caratteri) e dai caratteri nella stringa del campo.

Questo metodo è relativo solo ai campi di tipo SHORT_STRING.

Sintassi

VBScript

entity.GetFieldMaxLength field_name 

Perl

$entity->GetFieldMaxLength(field_name); 
Identificativo
Descrizione
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
field_name
Una stringa che identifica un nome del campo valido dell'entità. Il campo deve contenere una stringa di lunghezza fissa.
Valore di ritorno
Un valore Long che indica la lunghezza massima del campo. Il valore è il numero di byte come rappresentato nel database che può essere memorizzato dal campo.
Nota: il numero di byte non è uguale al numero di caratteri. Il numero esatto di byte necessario per rappresentare una stringa viene determinato dalla codepage del fornitore di database e dai caratteri specifici memorizzati nel campo. In base ai caratteri vengono utilizzati numeri di byte differenti e il numero di byte richiesti per memorizzare un carattere specifico dipende dalla codepage del fornitore di database.

Esempi

VBScript

' Check the maximum length of a string field. 
fieldType = GetFieldType("field1") 
If fieldType = AD_SHORT_STRING Then 
   maxLength = GetFieldMaxLength("field1") 
End If 

Perl

# Check the maximum length of a string field. 

$fieldtype = $entity->GetFieldType("field1");

if ($fieldtype eq $CQPerlExt::CQ_SHORT_STRING)

 {

 $maxlength = $entity->GetFieldMaxLength("field1");

 } 

Feedback