Skip to content

Commit 4967945

Browse files
committed
Moved properties and method overview to end of readme instead of in middle
1 parent ab1b976 commit 4967945

File tree

1 file changed

+37
-35
lines changed

1 file changed

+37
-35
lines changed

README.md

Lines changed: 37 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,42 @@ The ASPNetImage component essentially exposes part of the System.Drawing namespa
99
A debug and release build of the DLL is included in the repository, or you can compile it yourself after generating a signing key. Checkout a working copy of the source repository or you may download the current release in the Downloads section.
1010

1111

12+
# Environment Configuration
13+
14+
* Visual Studio 2010 or greater
15+
16+
* Install and configure NUnit. TestDriven.NET, which provides NUnit is available at http://testdriven.net/ You will need to add a reference to "nunit.framework.dll" in the UnitTests project.
17+
18+
* Configure DLL signing. In Visual Studio, open the ASPNetImage project properties and click on the "Signing" tab. Check the box labeled "Sign the assembly" and select "< New >" from the "Choose a strong name key file:" dropdown and follow the prompts.
19+
20+
* You should be able to build the DLL and run the unit tests at this point.
21+
22+
23+
# Troubleshooting
24+
25+
**Installation Issues**
26+
27+
* Verify that the .NET Framework v2.0 is installed and working properly.
28+
29+
* Ensure that you've registered the DLL with REGASM.EXE with the /tlb and /codebase command line switches (see the included register.bat file). You may want to unregister the DLL and re-register them to confirm.
30+
31+
* Make sure the DLL and TLB files have the correct file permissions. Give read/write/execute access to NETWORK, NETWORK_SERVICE and the IUSER_[machineName] accounts.
32+
33+
* If you are using an unsigned DLL, you will receive the following error message when registering the DLL with REGASM.EXE:
34+
35+
> RegAsm : warning RA0000 : Registering an unsigned assembly with /codebase can cause your assembly to interfere with other applications that may be installed on the same computer. The /codebase switch is intended to be used only with signed assemblies. Please give your assembly a strong name and re-register it.""
36+
37+
The object should still work, but I'd recommend unregistering it, compiling and signing the DLL yourself before registering it again so that you don't receive the warning message. Visual Studio 2005 and up can do this automatically from the Project Properties panel on the "Signing" tab. Just pick "< New >" and follow the prompts.
38+
39+
**Other**
40+
41+
* As of this writing, the precompiled DLL is only provided in 32bit format. There may be unknown issues running this on a 64bit OS. Precompiled 64bit variations are planned for sometime in the future.
42+
43+
* Some image format variations have been known to cause issues. Try alternate images from a different source. If you experience issues loading certain images and not others, please provide the problem image(s) if possible along with a bug report.
44+
45+
46+
47+
1248
# Properties and Methods
1349
ASPNetImage is a work in progress and any help completing the object is appreciated. All properties and methods are stubbed out, but as of this writing, currently only a small subset of properties and methods are implemented either in part or whole.
1450

@@ -122,38 +158,4 @@ ASPNetImage is a work in progress and any help completing the object is apprecia
122158

123159
* *TextOut*<br />Writes a string of text using the current font, font size and font characteristics.
124160

125-
* *TextWidth*<br />Returns the text width for a string value using the current font, font size and font characteristics.
126-
127-
128-
# Environment Configuration
129-
130-
* Visual Studio 2010 or greater
131-
132-
* Install and configure NUnit. TestDriven.NET, which provides NUnit is available at http://testdriven.net/ You will need to add a reference to "nunit.framework.dll" in the UnitTests project.
133-
134-
* Configure DLL signing. In Visual Studio, open the ASPNetImage project properties and click on the "Signing" tab. Check the box labeled "Sign the assembly" and select "< New >" from the "Choose a strong name key file:" dropdown and follow the prompts.
135-
136-
* You should be able to build the DLL and run the unit tests at this point.
137-
138-
139-
# Troubleshooting
140-
141-
**Installation Issues**
142-
143-
* Verify that the .NET Framework v2.0 is installed and working properly.
144-
145-
* Ensure that you've registered the DLL with REGASM.EXE with the /tlb and /codebase command line switches (see the included register.bat file). You may want to unregister the DLL and re-register them to confirm.
146-
147-
* Make sure the DLL and TLB files have the correct file permissions. Give read/write/execute access to NETWORK, NETWORK_SERVICE and the IUSER_[machineName] accounts.
148-
149-
* If you are using an unsigned DLL, you will receive the following error message when registering the DLL with REGASM.EXE:
150-
151-
> RegAsm : warning RA0000 : Registering an unsigned assembly with /codebase can cause your assembly to interfere with other applications that may be installed on the same computer. The /codebase switch is intended to be used only with signed assemblies. Please give your assembly a strong name and re-register it.""
152-
153-
The object should still work, but I'd recommend unregistering it, compiling and signing the DLL yourself before registering it again so that you don't receive the warning message. Visual Studio 2005 and up can do this automatically from the Project Properties panel on the "Signing" tab. Just pick "< New >" and follow the prompts.
154-
155-
**Other**
156-
157-
* As of this writing, the precompiled DLL is only provided in 32bit format. There may be unknown issues running this on a 64bit OS. Precompiled 64bit variations are planned for sometime in the future.
158-
159-
* Some image format variations have been known to cause issues. Try alternate images from a different source. If you experience issues loading certain images and not others, please provide the problem image(s) if possible along with a bug report.
161+
* *TextWidth*<br />Returns the text width for a string value using the current font, font size and font characteristics.

0 commit comments

Comments
 (0)