UseOffice .Net - methods and properties description

The component can convert between DOC, DOCX, XLS, PPT, CSV, RTF, Text and HTML formats with tables, images, fonts, colors etc.
This scheme shows all methods and properties of component:

int ConvertFile(string inputFile, string outputFile, eDirection convertingDirection)

This methods converts a file (DOC, DOCX, RTF, XLS, HTML, Text, PPT) into another file (DOC, DOCX, RTF, XLS, HTML, Text, PPT, Webarchive, Text Unicode).
The variable 'convertingDirection' allows to specify converting direction. For example: eDirection.HTML_to_DOC.

return values:

0 - converting OK
1 - can't open input file
2 - can't create output file
3 - converting Error
4 - MS Office isn't installed

Example C#:

 SautinSoft.UseOffice u = new SautinSoft.UseOffice();
 u.ConvertFile(@"d:\text.doc", @"d:\text.html", SautinSoft.UseOffice.eDirection.DOC_to_HTML);

Example VB:

 Dim u As New SautinSoft.UseOffice()
 u.ConvertFile("d:\text.doc", "d:\text.html", SautinSoft.UseOffice.eDirection.DOC_to_HTML)
      

To work our component UseOffice .Net requires MS Office installed. When you want to convert collection of documents at once we recomend you use also methods InitOffice(), InitWord() and InitExcel() togther with ConvertFile(). But if will skip the method InitOffice() so the ConvertFile() will work anyway.

Example C# - convert collection of files:

	SautinSoft.UseOffice u = new SautinSoft.UseOffice();
	string docFolder = @"d:\doc\";
	string htmlFolder = @"d:\html\";
	string[] files = Directory.GetFiles(docFolder, "*.doc");
			 
	//load MS Office in memory
	int office = u.InitOffice();
	
	//0 - loading OK
	//1 - can't load MS Excel (Word and PowePoint OK)
	//10 - can't load MS Word (Excel and PowerPoint OK)
	//11 - can't load MS Word and Excel (PowerPoint OK)
	//100 - can't load MS PowerPoint (Excel and Word OK)
	//101 - can't load MS Excel and PowerPoint (Word OK)
	//110 - can't load PowerPoint and Word (Excel OK)
	//111 - can't load MS Office
    
	if (office==0 || office==100 || office==101)
	{ 
	}
	else
	{
		//MS Office isn't installed
		return;
	}
    
	for (int i=0; i<files.Length; i++)
	{
		string htmlName = Path.Combine(htmlFolder,Path.GetFileNameWithoutExtension(files[i])+".htm");
		u.ConvertFile(files[i], @"d:\text.html", SautinSoft.UseOffice.eDirection.DOC_to_HTML);
	}
	u.CloseOffice();  

Example VB - convert collection of files:

	Dim u As New SautinSoft.UseOffice()
	Dim docFolder As String = "d:\doc\"
	Dim htmlFolder As String = "d:\html\"
	Dim files() As String = Directory.GetFiles(docFolder, "*.doc")
	
	'load MS Office in memory
	Dim office As Integer = u.InitOffice()		
	
	'0 - loading OK
	'1 - can't load MS Excel (Word and PowePoint OK)
	'10 - can't load MS Word (Excel and PowerPoint OK)
	'11 - can't load MS Word and Excel (PowerPoint OK)
	'100 - can't load MS PowerPoint (Excel and Word OK)
	'101 - can't load MS Excel and PowerPoint (Word OK)
	'110 - can't load PowerPoint and Word (Excel OK)
	'111 - can't load MS Office		
	
	If office=0 OrElse office=100 OrElse office=101 Then
	Else
	'MS Office isn't installed
	Return
	End If		

	For i As Integer = 0 To files.Length - 1
		Dim htmlName As String = Path.Combine(htmlFolder,Path.GetFileNameWithoutExtension(files(i)) & ".htm")
		u.ConvertFile(files(i), "d:\text.html", SautinSoft.UseOffice.eDirection.DOC_to_HTML)
	Next i
	u.CloseOffice() 

int InitOffice() int InitWord() int InitExcel() loads MS Office®, MS Word®, MS Excel® library in memory.

return values:

0 - loading OK
1 - can't load MS Excel (Word and PowePoint OK)
10 - can't load MS Word (Excel and PowerPoint OK)
11 - can't load MS Word and Excel (PowerPoint OK)
100 - can't load MS PowerPoint (Excel and Word OK)
101 - can't load MS Excel and PowerPoint (Word OK)
110 - can't load PowerPoint and Word (Excel OK)
111 - can't load MS Office

Example C#:

	SautinSoft.UseOffice u = new SautinSoft.UseOffice();			
	string[] docFiles = new string[] {@"d:\1.doc",@"d:\2.doc",@"d:\3.doc"};
	string[] rtfFiles = new string[] {@"d:\1.rtf",@"d:\2.rtf",@"d:\3.rtf"};
	
	//load MS Word in memory
	int word = u.InitWord();

	if (word!=0)
	{				
		//MS Word inn't installed
		return;
	}
														
	for (int i=0; i<docFiles.Length; i++)
	{
		u.ConvertFile(docFiles[i], rtfFiles[i], SautinSoft.UseOffice.eDirection.DOC_to_RTF);
	}
	u.CloseWord();

Example VB:

	Dim u As New SautinSoft.UseOffice()
	Dim docFiles() As String = {"d:\1.doc","d:\2.doc","d:\3.doc"}
	Dim rtfFiles() As String = {"d:\1.rtf","d:\2.rtf","d:\3.rtf"}

	'load MS Word in memory
	Dim word As Integer = u.InitWord()

	If word<>0 Then
		'MS Word inn't installed
		Return
	End If

	For i As Integer = 0 To docFiles.Length - 1
		u.ConvertFile(docFiles(i), rtfFiles(i), SautinSoft.UseOffice.eDirection.DOC_to_RTF)
	Next i
	u.CloseWord()

void CloseOffice() - releases MS Office® library from memory.
void CloseWord() - releases MS Word® library from memory.
void CloseExcel() - releases MS Excel® library from memory.

void KillProcesses(string procName) - terminates process by its name. Beware: this function kill all processes with specified name.

If Word, Excel or PowerPoint processes are still in memory you can use this function to terminate them.

Example C#:

u.KillProcesses("WINWORD");
u.KillProcesses("EXCEL");
u.KillProcesses("POWERPNT");

Example VB:

u.KillProcesses("WINWORD")
u.KillProcesses("EXCEL")
u.KillProcesses("POWERPNT")

SautinSoft.UseOffice.eDirection - enum which allows you to specify converting directions:

Serial - your individual serial number to activate your product copy

After purchasing you will get the full version of product and your serial number. This parameter doesn't have any effect in trial version. This parameter is necessary in full version, please don't forget to specify it by your serial number.

Possible values: any string
Default value: ""

Example C#: u.Serial = "XXXXXXXXX";

Example VB: u.Serial = "XXXXXXXXX"