Personal C Sharp         by    famsoft.org

Home | Demonstrative Examples | PC# Methods | PC# Reference | Links

How to start

Personal C Sharp software is very easy to set and use. The following step by step instructions will lead you to install the ".NET" Framework, install the "PC#" software and try your first program.

You need to install Microsoft ".Net Framework package and development kits, then install
Personal C# software.

[A] DOWNLOAD AND INSTALL THE .NET FRAMEWORK VERSION 2.0:

(1) From control panel "Add/Remove Software" uninstall all older versions.
(2) Click here to download "Microsoft .NET Framework Version 2.0 Redistributable Package".
http://www.microsoft.com/downloads/details.aspx?familyid=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displaylang=en

startup11.jpg

(3) Install the received file "dotnetfx.exe" by double-clicking its icon.
(4) Click here to download ".NET Framework 2.0 Software Development Kit (SDK) (x86)"
http://www.microsoft.com/downloads/details.aspx?familyid=FE6F2099-B7B4-4F47-A244-C96D69C35DEC&displaylang=en

startup12.jpg

(5) Install the received file "setup.exe" by double-clicking its icon.
(6) Browse to the folder: C:\Program Files\Microsoft.NET\SDK\v2.0\Bin  Make sure the file
    "SDKVars.bat" is available. When this batch file runs, it modifies the environment
    variables to make the ".NET" framework accessable. This modification is not permanet,
    which means, every time your computer is restarted, you need to run it again. PC#
    fixes this problem by rerunning the file for you whenever needed. At the beginning,
    when you install PC#, it copies the file to your working directory. Each time you
    use PC# after your computer has been restarted, PC# runs the file copy which is
    at your working directory.
   
    If you have chosen to install the ".NET" framework at a different location than
    the default, you have to find the file and copy it to your working directory by
    yourself. Otherwise, PC# will do this job for you.

startup13.jpg

[B] CREATE WOKING DIRECTORY:

Create a new directory for your PC# programming. You can place the new directory anywhere
and choose any name for it. However, if you ask for suggestion, "c:\pcs" is a good name
and location for the new folder.

[C] COPY PC# SOFTWARE TO YOUR WORKING DIRECTORY:

PC# software is delivered as one executable file named "pcs.exe". It could be sent
to you as an e-mail attachment, on a CD or floppy disc or as a download file.
Here is what you need to do in each case:

E-Mail attachment:

We are assuming that you are using the "Outlook Express" for your e-mail". If you are
using a different software, you may find some few differences which will not be hard to
work with.
 
Click on the attachment symbol on the top right corner of the message,
then click on "Save Attachments". If your mailing security setup allows saving the
attachment, a window should appear. Click on [Browse] at the bottom of the window. Browse
to your Working directory then click on [save].

If you find that you are unable to click on the attachment, you need to reduce your
security setup temporarely. To do so, click on  [Tools] at the top menu of the "Outlook
Express", Click on [Options] then click on the [Security] tab at the top of the
"Options" window.

Make sure the following Check Box is unchecked:
[ ] Do not allow attachments to be saved ...
Click on [Apply] then on [OK]. Close the Outlook Express window then start it back and
try again.

After completing your job, return your security settings to their original state.

A floppy disc or a CD:

Insert the disc into correct drive.
Click on [Start], [My Computer] then click on the drive where the disc is.
Use copy/paste to copy the file from the drive to your working directory.

A Download file:

Click on the Download Link. When the Internet Explorer's dialog appears, select "Save
to a file". Browse to your Working Directory and click on "Save".

[D] INSTALL PC# SOFTWARE INTO YOUR WORKING DIRECTORY:

From Command Mode, browse to your Working Directory then type: 
             pcs   And hit the [Enter] key.

Since the folder is new, PC# will prepare the folder for the new installation and ask you to
repeat what you have done.

startup14.jpg

Type:     pcs   And hit the [Enter] key again.
Read the License agreement. If acceptable, enter the word "yes" and hit [Enter]
The "Setup menu" should appear.

startup15.jpg

Select (c) from the setup menu to Create all necessary tools. Check your Working
directory. Make sure all expected files are there.

startup16.jpg

[E] PRACTICE WITH YOUR FIRST PROGRAM:
 
The easiest way to start is to practice with the "Demonstrative Examples" at
PC#'s website. You need to study them in order, starting with Example 1 of the
first group.
 
Use copy/paste to copy the code of the first example from the website to NotePad.

startup1.jpg

startup2.jpg

Save the program to a file named "a.cs" (to match the class name)
To do so, select [File], [Save As] frm top menu, Click the arrow of the selection box
labled "Save as type" and select "All Files". Type in the "File name" field "a.cs"
and click on [save]. Check the directory to make sure the new file "a.cs" is there.

Then, from Command mode enter:    pcpr a [Enter]

Example 1 displays the phrase "Hello World" on the system screen (not on the form),
so close the form's window to see the displayed text.

startup5.jpg

As you can see, when the environment variables have been checked, PC# software has found
that running the batch file "SDKVars.bat" which has been discussed earlier is necessary,
so it did before it executed the program. The two text lines starting with "Setting
environment" came from that file.
 
[F] GOING FURTHER:
 
If you have reached this point successfully, we would like to congratulate you. You
should have no problem with any other example or with writing your own programs at
the end.
 
Practice with each example, read all tutorials. They have been designed to teach you
learning how to use PC# software step by step. So you must study all the examples in
order. Don't move to the next example before you fully understand the current one.
 
We recommend printing a copy of the "PC# Reference" and "PC# Methods". Keep them by your
side. Whenever you find something unclear, look through them to find the answer.
 
PC# methods and field name are made to be as few, short and easy to remember as possible.
After some practice, you will be able to write programs which run without errors on the
first try. Enjoy your new programming experience!
 
REMARK: Some examples require the existance of an image file named "pix.jpg" in your
working directory. If you have received this file, copy it to your working directory.
If you have not received it, copy any other ".jpg" file which you can find in your
computer or on the web to your working directory and rename it to "pix.jpg".