Name
MSMQMailFormData MSMQMailFormField MSMQMailRecipient

The Name property identifies the name of a form (MSMQMailFormData), the name of a field on a form(MSMQMailFormField), or the name of an e-mail recipient(MSMQMailRecipient).

Quick Info

Syntax for form name

object1.object2.Name
 

Syntax for field name

object1.object2.object3.Item(IndexKey),Name
 

Syntax for sender recipient name

object1.object2.Name
 

Syntax for recipient name (in recipient list)

object1.object2.Item(IndexKey).Name
 

Settings

String that specifies the name of the form, form field, or e-mail recipient.

Remarks

Form Name

When sending a form to an Exchange user, this name should match the name of the field's Item Type as specified in the Exchange Form Designer. The Item Type can be found on the General page of the Field Properties dialog of the Exchange Form Designer. If they do not match, Microsoft Exchange may not display the form correctly.

Form Field Name

When used to specify the field of a form, this name should correspond to the name of the field's Reference Name as specified in the Exchange Form Designer. The Reference Name can be found on the General page of the Field Properties dialog of the Exchange Form Designer

If the correct Reference Name is not used, Microsoft Exchange may not display the field correctly.

E-mail Recipient Name

When used to specify an e-mail user, Name is only used for display purposes. It should contain the full name of the user.

Name is explicitly referenced to name the sender recipient. However, it is not referenced explicitly when naming a recipient in the recipient list. In these cases, the name is set when adding the recipient to the recipient list.

Example

This example defines an e-mail message as a form, setting the sender's name to "Our name", the recipient's name to "Exchange user", the form name to "Test form", and field name to "StringField". Then a message body is composed and all names are displayed.

To try this example using Microsoft Visual Basic (version 5.0), paste the code into the Code window of a form, then run the example and click the form.

Dim email As New MSMQMailEMail
Dim msg As New MSMQMessage

Private Sub Form_Click()

   '*********************
   '*  Define e-mail
   '*********************

   'Set e-mail type to form message.
   email.ContentType = MSMQMAIL_EMAIL_FORM
     
   'Set who sent the e-mail.
   email.Sender.Name = "Our name"
   email.Sender.Address = "Our queue label"

   'Add Recipients.
   email.Recipients.Add "Exchange user", "UserAlias@ServerInputQueueLabel", MSMQMAIL_RECIPIENT_TO, "Test"

   'Set subject of mail.
   email.Subject = "Test mail"
   
   '***************
   '*  Define form
   '***************

   'Set name of form
   email.FormData.Name = "Test form"
   
   'Set form field list.
   email.FormData.FormFields.Add "StringField", "Test Field", "Test"
   
   'Compose message Body
   msg.Body = email.ComposeBody


   '*****************
   '* Display names.
   '*****************

   MsgBox "Form name: " + email.FormData.Name
   MsgBox "Field name is: " + email.FormData.FormFields.Item("test").Name
   MsgBox "Sender recipient is: " + email.Sender.Name
   MsgBox "To recipient is: " + email.Recipients.Item("test").Name

End Sub
 

See Also

Add, Address, Body, ComposeBody, ContentType, FormData, FormFields, Item, MSMQMailEMail, MSMQMessage, Recipients, Sender, Subject

© 1997 by Microsoft Corporation. All rights reserved.