String Default Property, read only of FormField class

Default Property, read only | Member of  ScriptUtils.FormField | Changes | Purchase | Download

Description

Returns string representation of form field value. This is default value of a form field.

Syntax

vString = FormField.String ([CharSet as ConvertCodePages = CharSet], [Start as Long = Start of field], [Length as Long = Length of field])
 

Where Type Optional Default Description
 CharSet  ConvertCodePages  yes  CharSet  String or numeric (ConvertCodePages) expression that describes the character set of the property. 
 Start  Long  yes  Start of field  Start position to return string data 
 Length  Long  yes  Length of field  Length of source data to return 

Returns

String

Remarks

Source forms are usually encoded using ANSI code page.
You can use ScriptUtils.ConvertCodePages constants or Content-Type charset string representation to specify CodePage parameter, if your form is encoded using another code page,

Examples

Upload - Check file contents to ensure the field is really an image

Upload - Write contents of all text form fields

<%
  Dim Form: Set Form = Server.CreateObject("ScriptUtils.ASPForm")

  Response.Write "<br>Form.Items.Count:" & Form.Items.Count

  For Each Item In Form.Texts
    I = I + 1
    Response.Write "<br><br>Item no.:" & I

    'Write contents of the field.
    Response.Write "<br>Field Contents:" & Item.String

    'String is default property of FormField, so you can write
    Response.Write "<br>Field Contents:" & Item

  Next

%>  
<form name="file_upload" method="POST" ENCTYPE="multipart/form-data" >
<input Name="Description1" Value="Text in field Description 1"><br>
<input Name="Description2" Value="Text in field Description 2"><br>
<input Value="Submit >>" Type=Submit><br>
</Form>

Form output:
Form.Items.Count:2

Item no.:1
Field Contents:Text In field Description 1
Field Contents:Text In field Description 1

Item no.:2
Field Contents:Text In field Description 2
Field Contents:Text In field Description 2

Upload - Use x-mac-ce code page for form data.

<%

  Dim Form: Set Form = Server.CreateObject("ScriptUtils.ASPForm")

  'Set response.ContentType to x-mac-ce
  If Form.Items.Count=0 Then 
    Response.CharSet = "x-mac-ce"
  Else
    Response.Write "<br>Form.Items.Count:" & Form.Items.Count

    For Each Item In Form.Texts
      I = I + 1
      Response.Write "<br><br>Item no.:" & I
      Response.Write "<br>Length:" & Item.Length

      'Item.Name returns name of the source field encoded using x-mac-ce
      'you will see right characters if response.CharSet is set to "x-mac-ce"
      Response.Write "<br>Name:" & Item.Name

      'You can decode the name from x-mac-ce charset
      Response.Write "<br>Name encoded with x-mac-ce:" & Item.Name("x-mac-ce")
    
      'Same conversion for value of field.
      Response.Write "<br>Value:" & Item.Value.String
      Response.Write "<br>Value encoded with x-mac-ce:" & Item.Value.String("x-mac-ce")
    Next
  End If
%>  
<form name="file_upload" method="POST" ENCTYPE="multipart/form-data" >
<input Name="Description1" Value="Text1"><br>
<input Name="Description2" Value="Text2"><br>
<input Value="Submit >>" Type=Submit><br>
</Form>

See also

FormField.ByteArray, FormField.HexString, FormField.CharSet

Other links for String

Methods of FormField class

ContentCharSet, Save, SaveAs

Properties of FormField class

ByteArray, ContentDisposition, ContentTransferEncoding, ContentType, FileExt, FileName, FilePath, Header, Headers, HexString, CharSet, Index, InProgress, IsFile, Length, Name, RAWHeader, SourceLength, String, Value

ScriptUtils.FormField

One form field. Member of FormFields collection.

ScriptUtils

Huge ASP upload is easy to use, hi-performance ASP file upload component with progress bar indicator. This component lets you upload multiple files with size up to 4GB to a disk or a database along with another form fields. Huge ASP file upload is a most featured upload component on a market with competitive price and a great performance . The software has also a free version of asp upload with progress, called Pure asp upload , written in plain VBS, without components (so you do not need to install anything on server). This installation package contains also ScriptUtilities library. Script Utilities lets you create hi-performance log files , works with binary data , you can download multiple files with zip/arj compression, work with INI files and much more with the ASP utility.

© 1996 - 2011 Antonin Foller, Motobit Software | About, Contacts | e-mail: info@pstruh.cz


Other Motobit links:   IISTracer, real-time IIS monitor   ASP file upload - upload files to ASP. 
ActiveX/VBSScript registry editor  ActiveX NT User account manager  Export MDB/DBF from ASP Active LogFile  Email export  ActiveX/ASP Scripting Dictionary object