Serializes the current IForm and an instance of a business object bound to it to an XML string. The XML is processed by the WebLoader component to dynamically draw a form and display the business object's values in a Macromedia Flash form.

Parameters

dataSource

The business object instance to be serialized.

Return Value

An XML string representing the IForm and an associated business object instance.

Remarks

• SWF is the file extension of Macromedia Flash files. These are used by the WebLoader to display an IForm in a Web page.
• The difference between this method and SerializeDataSourceToSwfXml lies in the extent of the serialization: SerializeDataSourceToSwfXml serializes the business object (data source) only, whereas SerializeToSwfXml serializes both the IFormand the business object instance.
• This method is only used in conjunction with the WebLoader component. Use the LoaderControl or the LoaderForm components to display business object values in a Windows Forms environment.

Example

The following example demonstrates how to serialize an IForm and assign a DataUniqueID.

C# sample

using System;
using suite4.net.FormDatabase;
using suite4.net.Sample;
namespace suite4.net.Web.Sample
{
    public class FormServer : System.Web.Services.WebService
    {
        [System.Web.Services.WebMethod]
        public string SerializeForm(string formName)
        {
            string                    projectFileName;
            Employee                employee;
            IForm                        form;
            IProject                project;
            WebLoaderAlert    webLoaderAlert;

            projectFileName = this.Server.MapPath("\\sample")  "\\sample.fspj";
            project = Project.LoadFromFile(projectFileName);
            if(project != null)
            {
                form = project.GetForm(formName);
                if(form != null)
                {
                    employee = new Employee();
                    employee.EmployeeID    = 1;
                    employee.LastName        = "Robert";
                    employee.LastName        = "King";
                    form.DataUniqueID        = employee.EmployeeID.ToString();
                    form.WebLoaderEvent.WsdlUrl        = "/FormServer/FormServer.asmx?wsdl";
                    form.WebLoaderEvent.Operation    = "GetEmployee";
                    form.WebLoaderEvent.ClearParameters();
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.FormDatabase);
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.FormName);
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.DataUniqueID);
                    return form.SerializeToSwfXml(employee);
                }
                else
                {
                    webLoaderAlert = new WebLoaderAlert();
                    webLoaderAlert.Title = "Failed to load form";
                    webLoaderAlert.Message = "Can't find form "  formName;
                    return webLoaderAlert.SerializeToSwfXml();
                }
            }
            else
            {
                webLoaderAlert = new WebLoaderAlert();
                webLoaderAlert.Title = "Failed to load project";
                webLoaderAlert.Message = "Can't find project\n"  projectFileName;
                return webLoaderAlert.SerializeToSwfXml();
            }
        }
    }
}
            

VB.Net sample

Imports System
Imports suite4.net.FormDatabase
Imports suite4.net.Sample
Namespace suite4.net.Web.Sample
    Public Class FormServer
     Inherits System.Web.Services.WebService
        <System.Web.Services.WebMethod> _
        Public Function SerializeForm(ByVal formName As String) As String
            Dim projectFileName As String
            Dim employee As Employee
            Dim form As IForm
            Dim project As IProject
            Dim webLoaderAlert As WebLoaderAlert

            projectFileName = Me.Server.MapPath("\\sample")  "\\sample.fspj"
            project = Project.LoadFromFile(projectFileName)
            If Not project Is Nothing Then
                form = project.GetForm(formName)
                If Not form Is Nothing Then
                    employee = New Employee()
                    employee.EmployeeID    = 1
                    employee.LastName        = "Robert"
                    employee.LastName        = "King"
                    form.DataUniqueID        = employee.EmployeeID.ToString()
                    form.WebLoaderEvent.WsdlUrl        = "/FormServer/FormServer.asmx?wsdl"
                    form.WebLoaderEvent.Operation    = "GetEmployee"
                    form.WebLoaderEvent.ClearParameters()
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.FormDatabase)
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.FormName)
                    form.WebLoaderEvent.AddParameter(WebLoaderParameterType.DataUniqueID)
                    Return form.SerializeToSwfXml(employee)
                Else
                    webLoaderAlert = New WebLoaderAlert()
                    webLoaderAlert.Title = "Failed to load form"
                    webLoaderAlert.Message = "Can't find form "  formName
                    Return webLoaderAlert.SerializeToSwfXml()
                End If
            Else
                webLoaderAlert = New WebLoaderAlert()
                webLoaderAlert.Title = "Failed to load project"
                webLoaderAlert.Message = "Can't find project\n"  projectFileName
                Return webLoaderAlert.SerializeToSwfXml()
            End If
        End Function
    End Class
End Namespace

            

See Also

IForm Interface | suite4.net.FormDatabase Namespace | IForm.SerializeToSwfXml Overload List

---